クライアントサイドアーキテクチャー
Shell App Framework のクライアントアプリの構成
Shell App Framework のクライアントは、汎用的な WebView ベースのスマートフォンアプリケーションです。デベロッパーサイト上に登録された、画像および、サウンドファイルなどのアセットと Native 側の UI であるヘッダ、フッタ等のレイアウト情報を保持する XML ファイルとパッケージされアプリケーションが成り立っています。
JavaScript API
Shell App Framework のクライアントでは WebView内のHTMLコンテンツから Native アプリ側の機能を呼び出すための JavaScript APIを提供しており、バージョン情報の取得、ヘッダフッダなどのNative UI の操作、サウンドの制御、Remote Notification の通知情報の取得などを実装することができます。
これらの JavaScript API は WebView 内のページがロードされた後に初期化されますので、onShellAppReady というイベントが発生した後に利用可能になります。onShellAppReady イベントが発生するより前にこれらの JavaScript API を呼び出すと undefined のエラーになりますので注意してください。通常、onShellAppReady のイベントは、onLoad イベントの後に呼ばれます。
-
正しい実装
<script type="text/javascript" charset="utf-8">document.addEventListener('onShellAppReady', function(event) {// bgm1.ogg を再生mobage.shellapp.Music.play("bgm1.ogg", 1.0, -1);}, false);</script> -
誤った実装 (onLoadイベント内で使用する)
<script type="text/javascript" charset="utf-8">window.onload = function() {// bgm1.ogg を再生mobage.shellapp.Music.play("bgm1.ogg", 1.0, -1); // タイミングによってはエラーになる};</script>
サポート OS バージョン
- Android 2.3 以上
- iOS 5.0 以上
更新履歴
- 2013/11/12
- 対応OS をサポートOSバージョンに変更。
- 2013/04/05
- 対応OSを記載
- 2012/12/11
- 新規作成