■S!アプリ　技術資料　MIDP 2.0対応端末編　1.0.2　2007-07-20（約948 KB）　その２

覚書

EnhancedGraphics APIについて

SoftBankの独自規定API

API Ver 1.0 Ver 2.0 簡単な説明
drawPolyline ○ ○ 多折り線を描画する
fillPolygon ○ ○ 多角形（塗潰し）を描画する
getAntiAliasMode ― ○ 多折り線と多角形のアンチエイリアス状態を取得
setAntiAliasMode ― ○ 多折り線と多角形のアンチエイリアス状態をセット

3D Sound API

3Dポジショナル、ドップラー効果、リバーブ効果などの音楽再生時の表現力向上のために一部端末に搭載

対応ファイル形式

フォーマット 利用可否
MIDI(SMF) ○
SP-MIDI ○
SMAF ○
SMAF(SMAF/Phase) △
3GPP △
WAVE(PCM) ○
Tone Sequence ○
AMR NB △
MP4 △
リバーブ効果特記事項
  • 対応ファイル形式はSMAF/SMF/WAVE/Tone Sequence
  • 最大
  • 4チャンネル利用可能
  • SMAFファイルに3Dサウンド情報を埋め込むことも可能（その場合はS!アプリからの制御は不可）
  • MEXA/JSCLにより規定されたPlayerに対しての制御はできない

MMAPI(JSR 135)

インターフェイス Control
  • MIDP 2.0のS!アプリではストリーミング再生ができない
カメラ機能

WMA 1.1(JSR 120)

S!アプリによるSMS（J-Phoneのスカイメールのようなもの？）の送信と受信をサポートする

SMSの種類

種別 メールボックス 通知
S!アプリから送信したSMS 残らない ―
受信したSMS（ポート番号指定なし） 残る する
受信したSMS（ポート番号指定あり） 残らない しない

※残る　…　メールボックス上でユーザーの操作により確認できる
※残らない　…　メールボックス以外に保存され、ユーザーの操作では確認できない

特記事項
  • 配信確認は行われない
  • ポート番号を含むメッセージの取得は古いメッセージ順（FIFO）で行われ、取得後は削除される

M3G(JSR 184)

モバイル環境での3Dオブジェクトの描画機能
ここと株式会社エイチアイのツールを参照とのこと

S!アプリの利用API

利用可能プロファイル

  • CLDC 1.1/MIDP 2.0/3D Sound API/MEXA/JSCL

または

  • CLDC 1.1/MIDP 2.0/WMA 1.1/MMAPI 1.1/M3G/VSCL/3D Sound API
  • MEXA/JSCLと各JSRおよびVSCLの併用が可能
  • 同機能が含まれる場合は「MIDxlet-API」の記載によって動作が異なる

自動起動アプリ

種別 説明
時刻設定起動 PushRegistry.registerAlarm()で365日のうち1分単位の精度で動作する
SMS起動 MIDlet属性（MIDlet-Push-）でSMS起動のS!アプリとして登録する。もしくは、実行中にPushRegistry.registerConnection()で動的に登録する
Bluetooth起動 オフィシャルコンテンツのみで利用可

ブラウザ起動アプリ

object要素を埋め込んだWEBページからS!アプリを起動する方法

object要素
id a要素との関連付けを行うIDを指定する
type 「text/vnd.sun.j2me.app-discriptor」を指定する
declare インライン表示ができないので必ず「declere」を指定
classid 「x-oma-application:java-ams」を指定する
codebase Jadファイルの基準URL（スキーム名、ホスト名）を指定する
param要素
name value 説明
AMS-Filename （Jadファイル名） 起動を行うS!アプリのJadファイル名およびJadファイルのURLにおけるクエリ部分を記載する
MIDlet-Name （アプリ名） MIDlet属性で指定した値
MIDlet-Vendor （ベンダー名） MIDlet属性で指定した値
MIDlet-Version （バージョン） MIDlet属性で指定した値
AMS-Startup auto S!アプリが保存済みの場合はアプリの自動起動、保存されていない場合はアプリのダウンロードを行う
launch-only S!アプリが保存済みの場合はアプリの自動起動、保存されていない場合はアプリのダウンロードを行わない
download-confirm S!アプリが保存済みの場合はユーザーの選択でアプリを、保存されていない場合はアプリのダウンロードを行う
  • これらのパラメータはMEXA/JSCLまたはVSCL内のDeviceControl#getWakeupParam()にて取得可能
  • 受け渡しパラメータは10個まで指定可能で、name/valueのサイズはそれぞれUTF-8換算で256Bまで

【htmlの記述例】

<object id="example" type="text/vnd.sun.j2me.app-discriptor" declare="declare" classid="x-oma-application:java-ams" codebase="http://www.example.com">
 <param name="AMS-Filename" value="xxx.jad?id1=xxx&id2=xxx&id3=xxx"/>
 <param name="MIDlet-Name" value="sample"/>
 <param name="MIDlet-Vendor" value="SampleCompany"/>
 <param name="MIDlet-Version" value="1.0"/>
 <param name="AMS-Startup" value="auto"/>
</object>

<a href="#example">アプリ起動</a>

MIDP 2.0対応端末向けS!アプリのサイズ

サイズ
JADファイル 6KB以下
JARファイル 1MB以下
RecordStore 512KB以下
合計 1MB以下

※ダウンロード時に付加するのヘッダを含み1MB以下

データ格納領域

MIDP 2.0対応端末は下記の5ヶ所からデータを読み込める

データの種類 S!アプリ RecordStore 端末内ライブラリ S!アプリサーバ WEBサーバ
【画像】
PNG ○ ○ ○ × ○
JPEG ○ ○ ○ × ○
GIF ○ ○ ○ × ○
BITMAP ○ ○ × × ○
WBMP ○ ○ ○ × ○
SVG ○ ○ ○ × ○
Flash × ○ ○ × ○
【楽曲】
MIDI ○ ○ ○ × ○
SP-MIDI ○ ○ ○ × ○
SMAF/MA2 ○ ○ ○ × ○
SMAF/MA3 ○ ○ ○ × ○
SMAF/MA5 ○ ○ ○ × ○
SMAF/MA7 ○ ○ ○ × ○
SMAF/Phrase ○ ○ × × ○
AMR ○ ○ × × ○
PCM ○ ○ × × ○
Tone Sequence ○ ○ × × ○
MP4 ○ ○ × × ×
【動画】
3GPP × ○ ○ × ×
【3D】
モデル、アクション、テクスチャ ○ ○ × × ○
【その他】
JAD × ○ × ○ ×
JAR × ○ × ○ ○
任意のデータ ― ○ ― ― ―