Upload
zszzoklkda
View
654
Download
1
Embed Size (px)
Citation preview
AppliCast
アアププリリキキャャスストト開開発発ガガイイドド Rev 1.0.9
ソニー株式会社
TV 事業本部 技術部門
© 2006, 2007, 2008, 2009, 2010 Sony Corporation.
AC106-20100402-1
アプリキャスト開発ガイド
- 1 –
ははじじめめにに
1.1.1 本書の目的
このドキュメントは、『アプリキャスト開発ガイド』です。 ソニー株式会社製の BRAVIA 上で動作するアプリ
キャストの仕様が説明されています。
アプリキャストについてのより詳細な仕様については、『AppliCast Layout XML Specification』、 および
『AppliCast JavaScript API Specification』の各ドキュメントをあわせて参照してください。 また、XML や
JavaScript 言語について詳しくは、一般に出版されている書籍などを参照してください。
1.1.2 使用上の注意
• このドキュメントは、アプリキャストに関する情報提供のみを目的としています。
• このドキュメントは、予告なく変更されることがあります。
• このドキュメントに記載されている内容に関する技術的、または編集上の間違いや欠落について
は、一切の責任を負いません。また本資料に従った技術的措置、対応、実行、およびその結果
生じる必然的、間接的、偶発的損害についても、一切責任を負いません。
1.1.3 商標について
• “アプリキャスト”、”APPLICAST”はソニー株式会社の登録商標です。
• “BRAVIA”はソニー株式会社の登録商標です。
• “XMB”(“クロスメディアバー”、” “)はソニー株式会社および株式会社ソニー・コンピュータエ
ンタテインメントの商標です。
• “So-net”および“PostPet”はソネットエンタテインメント株式会社の登録商標です。
• JavaScriptTM は Sun Microsystems, Inc.の米国その他の国における登録商標です。
• その他、本書で登場するシステム名、製品名、サービス名、会社名は、一般に各メーカーの商標
または登録商標です。
1.1.4 著作権に関する注意
• このドキュメントに関する著作権は、ソニー株式会社にあります。
アプリキャスト開発ガイド
- 2 –
• このドキュメントに書かれている内容を、無断で複製、転載、改変することを禁じます。また、当社
の許可なく、Web をはじめとする公の媒体に対してこのドキュメントの内容を公開することを禁じ
ます。
1.1.5 表記上の規則
このドキュメントでは、解説文章の意味をよりはっきりとさせるために、以下のような表記形式を用いていま
す。
書体 意味
タイプライタ体 タグやプログラムのコードを表します。
特に表中の表記では、<>で囲まれているものは要素、囲まれていない場合は属性
を意味します。
イタリック体 変数や引数の名前を意味します。
[囲み文字] ボタンやキーを表します。
1.1.6 用語
用語 意味
アイテム XMB 上に表示されるコンテンツ、フォルダ、デバイスなどのいずれか。XMB 上に
アイコン表示されるもの
アプリ
アプリキャスト起動時に画面右側に表示される、それぞれ独立した小さなアプリ
ケーション。アプリキャスト・サーバからダウンロードされ、TV上で実行される小さ
なアプリケーション・プログラム(ウィジェットと、ウィジェットに提供されるコンテン
ツやサービスとから成る)
アプリリスト 使用可能なアプリの一覧。アプリキャスト・サーバからダウンロードしたウィジェッ
ト・カタログに従って生成される
ウィジェット スクリプトと XML などで定義される小さなアプリケーション・プログラム
ウィジェット・バンドル 提供されるウィジェットについてのデータ一式
カテゴリ XMB 上で横に分類されるもの。 “フォト”カテゴリ、“ミュージック”カテゴリ、“ビデ
オ”カテゴリなどがある
クロスメディアバー
(XMB) 十字に並んだアイコンで、チャンネルの切換やアプリケーションの選択ができる
ユーザインタフェース
アプリキャスト開発ガイド
- 3 –
目次
はじめに ...............................................................................................................................1
1.1.1 本書の目的 .................................................................................................................1 1.1.2 使用上の注意 .............................................................................................................1 1.1.3 商標について ..............................................................................................................1 1.1.4 著作権に関する注意....................................................................................................1 1.1.5 表記上の規則 .............................................................................................................2 1.1.6 用語............................................................................................................................2
1 アプリキャストの概要 ......................................................................................................5
1.1 アプリキャストとは .......................................................................................................................5 1.2 アプリキャストの仕組み ...............................................................................................................5
2 BRAVIAのアプリキャスト機能..........................................................................................6
2.1 アプリキャスト画面 ......................................................................................................................6 2.1.1 アプリのモード(ノーマル/フォーカス/アクティブ/フル(※2)) ................................................7 2.1.2 各モードの表示センター位置......................................................................................10 2.1.3 アプリ設定.................................................................................................................11 2.1.4 アプリケーション連携 .................................................................................................13 2.1.5 その他の操作............................................................................................................13
2.2 アプリリスト(XMB) ....................................................................................................................15 2.2.1 一覧表示...................................................................................................................15 2.2.2 アプリの登録と解除 ...................................................................................................16 2.2.3 「アプリ説明」の表示 ...................................................................................................16 2.2.4 「追加情報」の表示(※1) ................................................................................................17
3 アプリ開発 ......................................................................................................................18
3.1 アプリキャストの仕組み .............................................................................................................18 3.2 開発に必要な情報の入手..........................................................................................................19 3.3 ウィジェットの作成 .....................................................................................................................19
3.3.1 ウィジェット・バンドル..................................................................................................19 3.3.2 プロファイル ..............................................................................................................19
3.4 ウィジェットの実行方法 ..............................................................................................................20 3.4.1 ウェブサーバからダウンロードし実行する ...................................................................20 3.4.2 ローカルストレージから実行する ................................................................................20
3.5 ウィジェットの配信 .....................................................................................................................20
アプリキャスト開発ガイド
- 4 –
Appendix A ウィジェット・バンドル仕様 .........................................................................21
A.1 ウィジェット・バンドルの構成.......................................................................................................21 A.1.1 基本ファイル .............................................................................................................21 A.1.2 フル・モード用ファイル ...............................................................................................23
A.2 info.xml...................................................................................................................................23 A.2.1 XML仕様..................................................................................................................23 A.2.2 サンプル ...................................................................................................................24
A.3 contact.xml .............................................................................................................................24 A.3.1 XML仕様..................................................................................................................25 A.3.2 サンプル ...................................................................................................................25
A.4 preference.xml........................................................................................................................25 A.4.1 XML仕様..................................................................................................................25 A.4.2 サンプル ...................................................................................................................27
Appendix B ウィジェット・インフォ仕様 .........................................................................28
B.1 ウィジェット・インフォの構成........................................................................................................28 B.2 description.xml.......................................................................................................................28
B.2.1 XML仕様..................................................................................................................29 B.2.2 サンプル ...................................................................................................................29
Appendix C プロファイル仕様...........................................................................................30
Appendix D USBメモリの使用...........................................................................................31
D.1 USBメモリからのアプリ実行 ......................................................................................................31 D.2 USBメモリからアプリを実行するには .........................................................................................31
Appendix E アプリケーション連携....................................................................................32
E.1 Webブラウザ仕様 .....................................................................................................................32 E.2 フォトプレイヤー仕様 .................................................................................................................32 E.3 ミュージックプレイヤー仕様 ........................................................................................................33 E.4 ムービープレイヤー仕様............................................................................................................33
Appendix F 表示可能な文字・画像 ....................................................................................34
F.1 表示可能文字 ...........................................................................................................................34 F.2 表示可能画像 ...........................................................................................................................34
注釈 ....................................................................................................................................35
アプリキャスト開発ガイド
- 5 –
11 アアププリリキキャャスストトのの概概要要
1.1 アプリキャストとは
「アプリキャスト」とは、TV 番組などの映像を見ながら、ユーザが気になる情報を 2 画面モードで画面右側
に表示させるための仕組みです。 複数の情報を表示させておくことができ、内容はそれぞれ自動的に更
新されます。 また表示されている情報についての詳細は簡単なリモコン操作で見ることができます。
図 1-1 アプリキャスト表示画面
1.2 アプリキャストの仕組み
アプリキャストは TV 向けのウィジェット配信システムです。
ウィジェットとは主にスクリプトと XML で定義される小さなアプリケーション・プログラムでアプリキャスト・サ
ーバから TV に配信されます。 アプリキャストで実行されるアプリはこのウィジェットと、ウィジェットに対して
提供されるコンテンツやサービスで実現されます。
従来の TV 上で動作するアプリケーションと比較して、ウィジェットは開発や修正が容易であるため、ネット
ワーク上の多様なコンテンツやサービスと連携したアプリケーションを構築しやすいというメリットがありま
す。
アプリキャスト開発ガイド
- 6 –
22 BBRRAAVVIIAA ののアアププリリキキャャスストト機機能能
BRAVIA のアプリキャストは、主にアプリキャスト画面とアプリリストから構成されます。
アプリキャスト画面
実際にアプリが動作するアプリキャストのメイン画面
アプリリスト
利用可能なアプリの一覧
図 2-1 アプリリストとアプリキャスト画面
2.1 アプリキャスト画面
アプリが画面右側に並んで表示される画面です。 このとき画面左側には視聴中の映像が縮小表示されま
す。
アプリキャスト開発ガイド
- 7 –
図 2-2 アプリキャスト表示
アプリキャスト画面は以下のように様々な方法で起動することができます。
• リモコンの[アプリキャスト]ボタンを押す(※1)
• 視聴中画面のオプションメニューから[アプリキャスト]を選択する(※1)
• XMB のネットワーク・カテゴリにある“アプリキャスト”アイコンを選択する
• XMB のネットワーク・カテゴリにあるアプリリストからアプリを選択する
2.1.1 アプリのモード(ノーマル/フォーカス/アクティブ/フル(※2))
アプリキャスト画面で表示されるアプリには、それぞれ以下の動作モードがあります。 モード間の遷移は
ユーザのキー操作により強制的に行われます。
ノーマル・モード
複数のアプリが同時に表示されている状態です。
• 画面に表示されているアプリは同時に動作する
• アプリの表示サイズは 大で横 280×縦 165 ピクセル
• [↑][↓]でアプリがスクロールする
• [決定]でフォーカス・モードに遷移
• [戻る]で XMB のアプリリストに遷移
• 使用可能なメモリサイズは 1 アプリあたり 300KB
アプリキャスト開発ガイド
- 8 –
図 2-3 ノーマル・モード
フォーカス・モード
複数のアプリが同時に表示されているが、画面中央のアプリだけが選択されている状態です。
• 画面に表示されているアプリは同時に動作する
• 中央のアプリ以外はグレーアウト表示される
• アプリの表示サイズは 大で横 280×縦 165 ピクセル
• アプリはスクロールしない
• [決定]でアクティブ・モードに遷移
• [戻る]でノーマル・モードに遷移
• [↑][↓][←][→]をアプリが任意に使用可能
• 使用可能なメモリサイズは 1 アプリあたり 300KB
図 2-4 フォーカス・モード
アクティブ・モード
選択されたアプリだけを表示している状態です。
• 選択されていないアプリは動作停止する
• アプリの表示サイズは 大で横 300×縦 500 ピクセル
アプリキャスト開発ガイド
- 9 –
• [戻る]でノーマル・モードに遷移。このときアプリは再起動される
• [↑][↓][←][→][決定]をアプリが任意に使用可能
• [青][赤][緑][黄]をアプリが任意に使用可能(※2)
• Web ブラウザなどの組み込みアプリケーションを起動できる(※2)
• ダイアログを表示できる
• フル・モードに遷移することができる
• 使用可能なメモリサイズは 1.3MB
図 2-5 アクティブ・モード
フル・モード
画面全体を単一のアプリで表示する状態です。アクティブ・モードからのみ遷移することが可能です。
• 選択されていないアプリは動作停止する
• アプリの表示サイズは 大で横 960×縦 540 ピクセル(画面全体のサイズと同じ)
• [戻る]でノーマル・モードに遷移。このときアプリは再起動される
• [↑][↓][←][→][決定]をアプリが任意に使用可能
• [青][赤][緑][黄]をアプリが任意に使用可能(※2)
• Web ブラウザなどの組み込みアプリケーションを起動できる(※2)
• ダイアログを表示できる
• 使用可能なメモリサイズは 1 アプリあたり 4MB
アプリキャスト開発ガイド
- 10 –
図 2-6 フル・モード
アプリのモード間の遷移は以下のように[決定]または[戻る]で行います。
図 2-7 アプリキャストのモード遷移図
2.1.2 各モードの表示センター位置
アプリキャストでの各ウィジェットの表示領域の幅は、ノーマル・モード、フォーカス・モードで 280 ピクセル、
アクティブ・モードで 300 ピクセルです。アプリキャスト上には、ウィジェットの幅から中心位置を計算し、セン
ターを基準にウィジェットを表示しますが、アプリキャスト上でのセンターの位置は 図 2-8 のようになりま
す。
アプリキャスト開発ガイド
- 11 –
図 2-8 各モードのセンター位置
2.1.3 アプリ設定
アプリキャスト画面でオプションメニューから[アプリ設定]を選択すると、各アプリに関する個別の設定を行
うための画面が表示されます。
この画面ではアプリ毎に好みなどを設定してカスタマイズすることができます。 この設定はアプリ個別のも
のなので、設定内容はアプリ毎に異なります。
アクティブ・モード
フォーカス・モード
ノーマル・モード
ウィジェット表示領域
センターライン
140 140
140 140
140 160
アプリキャスト開発ガイド
- 12 –
図 2-9 「アプリ設定」画面
設定項目には以下のタイプがあります。
テキスト入力
任意のテキストを設定するための設定項目です。
• 項目を指定して[決定]を押すと、ソフトウエア・キーボードを表示
• ソフトウエア・キーボードは、全角漢字・ひらがな/半角英数字モード、または半角英数字モード
のみの 2 種類を選択可
• ユーザが入力できる文字数は、全角漢字・ひらがな/半角英数字モードの場合 12 文字(※3)、半
角英数字モードのみの場合は 128 文字まで
• 全角漢字・ひらがな/半角英数字モードは全角漢字・ひらがなモードで起動するが、ユーザによ
るモード切替で半角英数字も入力可能
• テキスト未入力時は”【未設定】”と表示
パスワード入力
パスワード文字列を入力するための設定項目です。
• 項目を指定して[決定]を押すと、ソフトウエア・キーボードを表示
• 入力したテキストは「*」で表示(※4)
• 半角英数字のみの入力
• ユーザが入力できる文字数は 128 文字まで
• パスワード未入力時は”【未設定】”と表示
シングルセレクト
あらかじめ決められた項目のうちの 1 つを選択させるための設定項目
• 選択項目は 大 60 個まで
アプリキャスト開発ガイド
- 13 –
• 選択項目として表示する文字列は 大全角 16 文字(※6)まで
• 項目未選択時は“【未設定】”と表示
チェックボックス
ユーザに決められた項目のうち、1 つ以上を選択させます。
• 設定項目は 大 6 個まで
• 設定項目の表示文字列は 大全角 10 文字(※6)まで
設定を変更した場合、[戻る]を押すと設定の保存確認ダイアログが表示されます。 また、設定画面を閉じ
ると、ノーマル・モードに戻りアプリが再起動されます。
2.1.4 アプリケーション連携
アプリキャストのアプリは BRAVIA に搭載されている Web ブラウザを起動して、任意のウェブページを表示
させることができます。
またモデルによってはWebブラウザ以外のアプリケーションを呼び出すことが可能です。 連携可能なアプ
リケーションについて詳しくは『Appendix C プロファイル仕様』を参照して下さい。
2.1.5 その他の操作
2.1.5.1 アプリの登録と解除
アプリキャスト画面でオプションメニューから[登録]または[登録解除]を選択することにより、アプリの登録
状態を変更することができます。
「登録」されたアプリは、次回以降のアプリキャスト起動時に自動でダウンロード・実行されるようになります。
また「アプリ設定」で設定された情報を、次回以降のアプリキャスト起動でも参照できるようになります。
アプリが未登録の状態でアプリキャストを終了する場合、登録確認画面が表示されます。
アプリキャスト開発ガイド
- 14 –
図 2-10 アプリの登録確認画面
2.1.5.2 アプリの複製 (※1)
アプリキャスト画面でオプションメニューから[コピーを登録]を選択することにより、選択されているアプリの
コピーを作成し、アプリキャストへの登録を行うことができます。
このときコピーされたアプリには「アプリ設定」は引き継がれません。
アプリの複製を可能にする方法については、『A.2 info.xml』を参照してください。
2.1.5.3 「お問い合わせ」の表示
アプリに関するお問い合わせ先を表示する画面です。 アプリキャスト画面のオプションメニューから[お問
い合わせ]を選択して表示します。
「お問い合わせ」画面では、以下の情報を表示します。
• アプリの名称
• アプリの提供者名
• アプリに関するお問い合わせ先(電話番号)
• アプリのお問い合わせ先に関する補足情報
• アプリに関するお問い合わせ先ボタン
[決定]を押すと Web ブラウザが起動しアプリに関するお問い合わせ先やサポート情報を
表示します。
アプリキャスト開発ガイド
- 15 –
図 2-11 「お問い合わせ」画面
2.2 アプリリスト(XMB)
XMB のネットワーク・カテゴリに並んでいるアプリキャストで実行可能なアプリ一覧のことを「アプリリスト」と
呼びます。
アプリキャストはここから起動することができます。 またアプリの登録、解除などの操作もここから行うこと
ができます。
図 2-12 アプリリストの項目
2.2.1 一覧表示
アプリリストにはアプリ毎に以下のような情報を表示することができます。
アプリキャスト開発ガイド
- 16 –
• アプリのアイコン
• アプリの名称
• アプリの説明
• アプリの提供者
• アプリの状態
• アプリの登録状況(登録済みの場合のみ表示)
アプリリストのアプリを選択した状態で[決定]を押すと、アプリキャスト画面に遷移し、選択したアプリを実行
することができます。
すでに登録されているアプリを実行した場合には、そのアプリを中央に表示した状態でアプリキャストを起
動します。 登録されていないアプリを実行した場合は、一番下にそのアプリを追加した状態でアプリキャ
ストを起動します。
“アプリキャスト”アイコンを選択し[決定]を押すことで、アプリキャストを起動することもできます。 このとき
アプリキャストの中央には、前回アプリキャスト終了時に選択されていたアプリが表示されます。
2.2.2 アプリの登録と解除
アプリリストのアプリを選択した状態で、オプションメニューから[登録]または[登録解除]を選択することに
より、アプリの登録状態を変更することができます。
「登録」されたアプリは、アプリキャスト起動時に自動でダウンロード・実行されるようになります。
登録されているアプリは、アプリリストの項目に“登録済”アイコンが表示されます。
2.2.3 「アプリ説明」の表示
各アプリの説明を表示する画面。 アプリリストのオプションメニューから[アプリ説明]を選択して表示しま
す。
「アプリ説明」画面では、以下の情報を表示します。
• アプリのアイコン
• アプリの名称
• アプリの状態
• アプリのイメージ画像
• アプリの詳細説明
• アプリの提供者名
• アプリに関するお問い合わせ先(電話番号)
• アプリに関するお問い合わせ先ボタン
[決定]を押すと Web ブラウザが起動しアプリに関するお問い合わせ先やサポート情報を
表示します。
アプリキャスト開発ガイド
- 17 –
• アプリの登録状況(登録済みの場合のみ表示)
図 2-13 「アプリ説明」画面
2.2.4 「追加情報」の表示(※1)
アプリのアイコンを選択した状態でしばらくすると、XMB 上にアプリについての追加情報が表示されます。
図 2-14 アプリの「追加情報」表示画面
「追加情報」では以下の情報を表示します。
• アプリのイメージ画像
• アプリの詳細説明
アプリキャスト開発ガイド
- 18 –
33 アアププリリ開開発発
3.1 アプリキャストの仕組み
アプリキャストのアプリは
• スクリプトと XML などで定義される小さなプログラムであるウィジェット
• ウィジェットから非同期で取得されるコンテンツ
から構成されています。
アプリキャストのシステムは
• ウィジェットを配信するアプリキャスト・サーバ
• コンテンツを配信するコンテンツ・サーバ
• クライアントとしてアプリを実行する TV
から構成されています。
アプリキャストクライアントは、アプリキャスト起動時にユーザがアプリリストから選択または登録したアプリ
に対応するウィジェットを実行します。ウィジェットはクライアントにインストールされるのではなく、アプリキ
ャストが起動されるたびに毎回ダウンロードされ、実行されます。そのためユーザは常に 新のウィジェッ
トを利用できます。同時に実行されたウィジェットはそれぞれ任意のコンテンツ・サーバにアクセスし、非同
期に必要なデータを取得し表示します。
図 3-1 アプリキャストの仕組み
アプリキャスト開発ガイド
- 19 –
3.2 開発に必要な情報の入手
ウィジェットを開発するためには、アプリの仮想実行環境であるアプリキャスト・エミュレータや、開発に必要
なドキュメントを入手する必要があります。また、サンプルアプリも提供されています。
エミュレータは Windows PC 上で動作し、アプリをデバッグするため機能を備えています。開発に必要な情
報の入手方法については下記サイトを参照して下さい。
なお、法人のお客様で、アプリリスト(XMB)へのアプリのご提供を検討されている方は、同サイトの「法人の
お客様はこちら」の情報をご参照ください。
3.3 ウィジェットの作成
3.3.1 ウィジェット・バンドル
アプリキャストのウィジェットは、ウィジェット・バンドルと呼ばれるファイル群で構成されています。
ウィジェット・バンドルには、
• ウィジェットの動作を記述する JavaScript ファイル
• レイアウト情報を記述する XML ファイル
• アプリ名などのメタデータを記述するため XML ファイル
• 各種画像ファイル
が含まれます。
ウィジェット・バンドルについての詳細は『Appendix A ウィジェット・バンドル仕様』を参照して下さい。
3.3.2 プロファイル
ウィジェットが使用できる機能セット(JavaScript API など)のことをプロファイルと呼びます。 プロファイル
はウィジェットを実行する環境などによって一部制限される場合があります。
プロファイルについての詳細は『Appendix C プロファイル仕様』を参照して下さい。
http://www.sony.jp/products/Consumer/bravia/technology/applicast/develop02.html
アプリキャスト開発ガイド
- 20 –
3.4 ウィジェットの実行方法
ウィジェットをクライアントで実行するには、2 通りの方法があります。
3.4.1 ウェブサーバからダウンロードし実行する
アプリキャストクライアントはウィジェットをウェブサーバからダウンロードして実行することができます。
アプリキャストクライアントからウィジェットをダウンロードするためには、「ウィジェット・バンドル」と「ウィジェ
ット・カタログ」をウェブサーバ上に配置する必要があります。
エミュレータへのウィジェット・カタログの設定方法については、エミュレータに付属のドキュメントを参照して
下さい。
3.4.2 ローカルストレージから実行する
エミュレータでは、PC の HDD 上にあるウィジェットを読み込んで実行することができます。詳しくはエミュレ
ータに付属のドキュメントを参照して下さい。
一部のBRAVIAではUSBメモリからウィジェットを読み込んで実行することができます。(※1) 詳しくは
『Appendix D USBメモリの使用』を参照して下さい。
3.5 ウィジェットの配信
アプリをアプリリストに掲載するには、作成したウィジェット・バンドルをソニーに提出する必要があります。
提出されたウィジェット・バンドルはアプリキャスト・サーバに配置されます。
アプリキャスト開発ガイド
- 21 –
AAppppeennddiixx AA ウウィィジジェェッットト・・ババンンドドルル仕仕様様
A.1 ウィジェット・バンドルの構成
「ウィジェット・バンドル」はウィジェットの振る舞いを規定するためのファイル群です。必要とされるファイル
の構成は、作成するウィジェットの適用範囲に応じて異なります。
基本ファイル
すべてのウィジェットに必要なファイル一式です
フル・モード用ファイル
ウィジェットでフル・モードを使用する場合に必要なファイル一式です
フル・モードを持たないウィジェットでは必要ありません
A.1.1 基本ファイル
基本ファイルでは、主にアプリキャスト画面のノーマル・モード/フォーカス・モード/アクティブ・モードにおけ
るウィジェットの振る舞いを規定します。 アプリキャスト起動時に読み込まれ、画面上に表示されているウ
ィジェットから実行されます。
基本ファイルは、以下のファイル群から構成されます。これらのファイルはウィジェット・バンドルのディレク
トリ直下に配置する必要があります。
widget.js (必須)
• ノーマル・モード、フォーカス・モード、アクティブ・モードでのウィジェットの振る舞いを記述した
JavaScript ファイル
• 仕様の詳細については『AppliCast JavaScript API Specification』のドキュメントを参照
• 大ファイルサイズは 48Kbyte
• 文字コードは UTF-8(BOM なし)、改行コードは LF
layout.xml (必須)
• ノーマル・モード、フォーカス・モード、アクティブ・モードでのウィジェットのレイアウトを記述した
XML ファイル
• 仕様の詳細については『AppliCast Layout XML Specification』のドキュメントを参照
• 大ファイルサイズは 8Kbyte
アプリキャスト開発ガイド
- 22 –
• 文字コードは UTF-8(BOM なし)、改行コードは LF
info.xml (必須)
• ウィジェットに関する各種情報を記述した XML ファイル
• 大ファイルサイズは 1Kbyte
• 文字コードは UTF-8(BOM なし)、改行コードは LF
bg.png (必須)
• ノーマル・モード、フォーカス・モード、アクティブ・モードで使用する初期背景画像
• layout.xml に記述された"initial-bg"という名前の Bitmap ノードに自動的に読み込まれ
る
• 画像サイズの大きさは info.xml で指定したサイズ以下
• 画像ファイルのフォーマットは、PNG 8bit CLUT
• 大ファイルサイズは 8Kbyte
icon.png (必須)
• アプリリストや、アプリ説明で使用するアプリのアイコン画像
• 画像ファイルのフォーマットは、PNG 8bit CLUT
• 画像サイズは横 77×縦 77 ピクセル
• 上下左右に 7 ピクセルのマージンが必要
contact.xml (必須)
• アプリに関するユーザの問い合わせ先を記述した XML ファイル
• 大ファイルサイズは 5Kbyte
• 文字コードは UTF-8(BOM なし)、改行コードは LF
preference.xml (オプション)
• アプリに関する設定項目を記述した XML ファイル
• 大ファイルサイズは 5Kbyte
• 文字コードは UTF-8(BOM なし)、改行コードは LF
なお個別の 大ファイルサイズ制限とは別に、以下の条件を満たす必要があります。
• widget.js, layout.xml, info.xml, bg.png のファイルサイズは合計で 48Kbyte まで
アプリキャスト開発ガイド
- 23 –
A.1.2 フル・モード用ファイル
アプリキャスト画面のフル・モードでの振る舞いを規定するファイルです。 アプリキャスト画面のフル・モー
ドに遷移した時に読み込まれ、実行されます。
以下のファイルから構成されます。
widget_fullscreen.js (オプション)
• フル・モードでのウィジェットの振る舞いを記述した JavaScript ファイル
• 仕様の詳細については『AppliCast JavaScript API Specification』のドキュメントを参照
• 大ファイルサイズは 256Kbyte
• 文字コードは UTF-8(BOM なし)、改行コードは LF
layout_fullscreen.xml (オプション)
• フル・モードでのウィジェットのレイアウトを記述した XML ファイル
• 仕様の詳細については『AppliCast Layout XML Specification』のドキュメントを参照
• 大ファイルサイズは 128Kbyte
• 文字コードは UTF-8(BOM なし)、改行コードは LF
A.2 info.xml
アプリに関する各種情報を記述した XML ファイルです。
A.2.1 XML 仕様
• ルート要素として<Info>を持ちます
• ルート要素<Info>は以下の子要素を持ちます
<name> 必須 アプリの名称(※5)。 大全角 22 文字(※6)
<width> 必須 幅。 大 280 ピクセル。アプリのノーマル・モードとフォーカス・モー
ドのうち、 大の値
<height> 必須 高さ。 大 165 ピクセル。アプリのノーマル・モードとフォーカス・モ
ードのうち、 大の値
<preference> 必須 「アプリ設定」画面のあり(1)、なし(0)を設定
アプリキャスト開発ガイド
- 24 –
<profile> 必須 子要素として一つ以上の"<spec>プロファイル記述</spec>"を持
つ。
プロファイルについては『Appendix C プロファイル仕様』を参照
<duplicable> オプション アプリの複製(コピー登録)の有効(1)、無効(0)を設定。デフォルト
は無効(※1)
<fullscreen> オプション アプリがフル・モードに遷移することが可能(1)、不可(0)を設定。デ
フォルトは不可(※2)
<description> オプション アプリの簡単な説明文。 大全角 33 文字(※6)。
<provider> オプション アプリの提供者名(アプリの作成者名を表記する)。
contact.xml の<provider>と一致していること。 大全角
33 文字(※6)
A.2.2 サンプル
<?xml version="1.0" encoding="UTF-8" ?>
<Info>
<name>サニーちゃんの星占い</name>
<width>280</width>
<height>165</height>
<preference>1</preference>
<profile>
<spec>AC2.0</spec>
</profile>
<duplicable>1</duplicable>
<fullscreen>1</fullscreen>
<description>あなたの今日の運勢をチェックできます</description>
<provider>サニーちゃん研究所</provider>
</Info>
A.3 contact.xml
各アプリに関するユーザの問い合わせ先を記述した XML ファイルです。 このファイルに記述された情報を
元に、アプリキャスト画面における「お問い合わせ」画面が形成されます。
アプリキャスト開発ガイド
- 25 –
A.3.1 XML 仕様
• ルート要素として<ContactInfo>を持ちます。
• ルート要素<ContactInfo>は以下の子要素を持ちます。
<provider> 必須 アプリの提供者名。description.xml の<provider>と一致して
いること。 大全角 33 文字(※6)
<contact> 必須 アプリに関するお問い合わせ先。description.xml の
<contact>と一致していること。 大全角 36 文字(※6)
<url> オプション アプリに関するお問い合わせ先情報 URL。[詳細を見る]ボタンを押す
と、このURLのサイトを表示する。description.xmlの<url>と一
致していること。 大 256byte
<detail> 必須 アプリのお問い合わせ先に関する補足情報。 大全角 80 文字(※6)
A.3.2 サンプル
<?xml version="1.0" encoding="UTF-8" ?>
<ContactInfo>
<provider>サニーちゃん研究所</provider>
<contact>03-1234-xxxx</contact>
<url>http://example.com/about/hoshiuranai/</url>
<detail>サービスについてのお問い合わせはお客様ご相談センターへ。</detail>
</ContactInfo>
A.4 preference.xml
個々のアプリに対する設定項目が記述された XML ファイルです。 このファイルに記述された情報を元に、
アプリキャスト画面における「アプリ設定」画面が形成されます。
A.4.1 XML 仕様
• ルート要素<Preference>を持ちます。
• ルート要素<Preference>以下に、設定項目として<Item>を 3 つまで記述できます。
アプリキャスト開発ガイド
- 26 –
• <Item>は以下の属性を持ちます。
name 必須 設定項目名。"Item1", "Item2", "Item3"を、この順番に必要な数だけ指
定。3 つ全ての設定項目を指定する必要はない。"Item1"は画面中央、
"Item2"は画面上部、"Item3"は画面下部に配置される
type 必須 設定項目の入力タイプ。"text"(テキスト), "password"(パスワード入力),
"single_select"(シングルセレクト), "multi_select"(チェックボックス)
のいずれか
label 必須 設定項目の説明文。 大全角 43 文字(※6)
• <Item>は type の値に応じて上記以外の属性値、または子要素を持つ場合があります。
A.4.1.1 テキスト入力 (text)
• <Item>の属性値として以下を設定します。
multibyte オプション ソフトウエア・キーボードの入力モード設定。全角漢字・ひらがな/半
角英数字(1)、または半角英数字のみ(0)を設定。デフォルトは 0
A.4.1.2 パスワード入力 (password)
• <Item>の属性値、子要素はありません。
A.4.1.3 シングルセレクト (single_select)
• <Item>の子要素として、 大で 60 個まで<option>要素を持つことができます。
• <option>要素は以下の属性値、および子要素を持つことで選択可能な項目を形成します。
value 必須 項目の選択時に実際に設定される値。半角英数のみ指定可能。 大半角 20
文字まで
(text) 必須 選択項目として表示される文字列。 大全角 16 文字(※6)
A.4.1.4 チェックボックス (multi_select)
• <Item>の子要素として、 大で 6 個まで<option>要素を持つことができます。
• <option>要素は以下の属性値、および子要素を持つことで選択可能な項目を形成します。
アプリキャスト開発ガイド
- 27 –
value 必須 項目の選択時に実際に設定される値。半角英数のみ指定可能。 大半角 20
文字まで
(text) 必須 選択項目として表示される文字列。 大全角 10 文字(※6)
A.4.2 サンプル
<?xml version="1.0" encoding="UTF-8" ?>
<Preference>
<Item name="Item1" type="text" label="あなたのお名前" multibyte="1" />
<Item name="Item2" type="single_select" label="星座">
<option value="1">牡羊座</option>
<option value="2">牡牛座</option>
<option value="3">双子座</option>
<option value="4">蟹座</option>
<option value="5">獅子座</option>
<option value="6">乙女座</option>
<option value="7">天秤座</option>
<option value="8">蠍座</option>
<option value="9">射手座</option>
<option value="10">山羊座</option>
<option value="11">水瓶座</option>
<option value="12">魚座</option>
</Item>
<Item name="Item3" type="multi_select" label="好きな食べ物">
<option value="1">カレーライス</option>
<option value="2">パスタ</option>
<option value="3">うなぎ</option>
<option value="4">オムライス</option>
<option value="5">親子丼</option>
<option value="6">坦々麺</option>
</Item>
</Preference>
アプリキャスト開発ガイド
- 28 –
AAppppeennddiixx BB ウウィィジジェェッットト・・イインンフフォォ仕仕様様
B.1 ウィジェット・インフォの構成
「ウィジェット・インフォ」は、個々のアプリに関する説明を記述するためのファイル群です。以下のファイル
から構成されます。
description.xml (必須)
• 個々のアプリに関する説明文が記述された XML ファイル。「アプリ説明」の表示に使用
• アプリごとに用意する必要がある
• 大ファイルサイズは 10Kbyte
• 文字コードは UTF-8(BOM なし)、改行コードは LF
thumbnail.png (必須)
• アプリのイメージ画像。「アプリ説明」画面で使用
• アプリごとに用意する必要がある
• 画像ファイルのフォーマットは、PNG 8bit CLUT
• 画像サイズは横 285×縦 165 ピクセル
これらのファイルは全て同じディレクトリに配置する必要があります。
B.2 description.xml
このファイルに記述された情報を元に、アプリリストの「アプリ説明」画面が形成されます。
Catalog.xml の<Widget>要素中に以下のようにファイル名を記述します。
<information>http://example.com/description.xml</information>
アプリキャスト開発ガイド
- 29 –
B.2.1 XML 仕様
• ルート要素<Information>を持ちます
• ルート要素<Information>は以下の子要素を持ちます。
<name> 必須 アプリの名称(※5)。info.xml の<name>と一致していること。 大全
角 22 文字(※6)
<provider> 必須 アプリの提供者名(アプリの作成者名を表記する)。contact.xml の
<provider>と一致していること。 大全角 33 文字(※6)
<detail> オプション アプリの詳細説明。 大全角 184 文字(全角 23 文字×8 行(※6))
<contact> 必須 アプリに関するお問い合わせ先。電話番号やメールアドレスを記載。
contact.xml の<contact>と一致していること。 大全角 36 文字(※6)
<url> オプション アプリに関するお問い合わせ先情報 URL。[お問い合わせ]ボタンを押
すと、この URL のサイトを表示する。contact.xml の<url>と一致
していること。 大 256byte
B.2.2 サンプル
<?xml version="1.0" encoding="UTF-8" ?>
<Information>
<name>サニーちゃんの星占い</name>
<provider>サニーちゃん研究所</provider>
<detail>サニーちゃんがあなたの今日の運勢を占ってくれます。
サニーちゃんはのんびり屋さんでいつも
お昼寝していますが、特技の星占いはよくあたります。</detail>
<contact>03-1234-xxxx</contact>
<url>http://example.com/about/hoshiuranai/</url>
</Information>
アプリキャスト開発ガイド
- 30 –
AAppppeennddiixx CC ププロロフファァイイルル仕仕様様
ウィジェットが使用できる機能セット(JavaScript API など)のことをプロファイルと呼びます。
プロファイル フル・モード Web ブラウザ
起動
フォト
プレイヤー
起動
ミュージック
プレイヤー
起動
ムービー
プレイヤー
起動
[青][赤][緑][黄]
キー
AC1.0 - ○ - - - -
AC1.1 - ○ ○ - - -
AC2.0 ○ ○ ○ ○ ○ ○
プロファイルはウィジェットを実行する環境などによって一部制限される場合があります。(※1)
ウィジェットは info.xml に以下のような形で対応するプロファイルを宣言します。
<?xml version="1.0" encoding="UTF-8" ?>
<Info>
....
<profile>
<spec>AC1.0</spec>
</profile>
....
</Info>
宣言したプロファイルによってウィジェットが使用できる機能セット(JavaScript API など)が異なります。 詳
細については『AppliCast JavaScript API Specification』、『AppliCast Layout XML Specification』のドキュメ
ントを参照してください。
アプリキャスト開発ガイド
- 31 –
AAppppeennddiixx DD UUSSBB メメモモリリのの使使用用
D.1 USB メモリからのアプリ実行
USB メモリを BRAVIA に接続することで、USB メモリ内のアプリを実行することが可能です。
注)アプリの動作確認のための機能です。USB メモリから実行したアプリによって生じる必然的、間接的、
偶発的損害について、ソニー株式会社は一切責任を負いません。
D.2 USB メモリからアプリを実行するには
USB メモリ内の任意の位置に、ウィジェット・バンドルを格納します。
BRAVIA にウィジェット・バンドルの格納された USB メモリを接続すると、アプリリスト上に「USB」フォルダが
表示されます。
図 3-2 アプリリストに表示される「USB」フォルダ
アプリキャスト開発ガイド
- 32 –
AAppppeennddiixx EE アアププリリケケーーシショョンン連連携携
アプリキャストのアプリは BRAVIA に搭載されている以下のアプリケーションを起動することができます(※2)
• Web ブラウザ
• フォトプレイヤー
• ミュージックプレイヤー
• ムービープレイヤー
E.1 Web ブラウザ仕様
項目 対応環境
記述言語 HTML4.01 準拠
スタイルシート規格 CSS1 / CSS2 (Subset)
動作記述言語 JavaScript1.5
セキュア通信 SSL2.0 / SSL3.0
Cookie RFC2109 & RFC2965 (Cookie2)
モノメディア(静止画) JPEG, PNG, GIF
文字入力 画面キーボード方式
コンテンツ表示領域 890x502 ピクセル
(スクロールバーの表示によっては、
一部隠される可能性があります)
カラーモデル 32bit RGB
E.2 フォトプレイヤー仕様
フォトプレイヤーを利用する場合、以下のフォーマットのコンテンツを再生できます。
JPEG(非プログレッシブ)形式
• EXIF 2.2 以前のバージョン
• sRGB または Uncalibrated color space
アプリキャスト開発ガイド
- 33 –
解像度 : 4096x4096 以下
• フル画面で表示させる場合には、1920x1080 を推奨
E.3 ミュージックプレイヤー仕様
ミュージックプレイヤーを利用する場合、以下のフォーマットのコンテンツを再生できます。
MP3(stereo)形式
• サンプリング周波数:44.1kHz
• ビットレート:32, 64, 128, 192, 256, 320kbps(CBR/VBR)
E.4 ムービープレイヤー仕様
ムービープレイヤーを利用する場合、以下のフォーマットのコンテンツを再生できます。
MPEG-2PS 形式
• ビットレート: 大 10.08Mbps
• 解像度:720×480, 704×480, 544×480, 480×480, 352×480, 352x240
• 音声:LPCM(mono 768kbps / stereo 1.536Mbps), MPEG-1/2 Layer2(mono 64~192kbps / stereo
64~384kbps)
アプリキャスト開発ガイド
- 34 –
AAppppeennddiixx FF 表表示示可可能能なな文文字字・・画画像像
F.1 表示可能文字
使用フォント: ARIB-新ゴ R
アプリキャストでは、JIS 基本漢字(規格番号 JIS X 0208)のうち、以下の第 2 水準漢字までをサポートして
います。具体的な文字については、一般に出版されている書籍などを参照してください。
記号、英数字、かな (01 区~08 区)
第 1 水準漢字 (16 区~47 区)
第 2 水準漢字 (48 区~84 区)
ただし、上記のうち、以下の文字は表示されません(空白文字または代替文字になります)。
区点 JIS SJIS EUC 文字
01 区 0x2141 0x8160 0xA1C1 ~ (全角波形)
01 区 0x2142 0x8161 0xA1C2 ∥
01 区 0x215D 0x817C 0xA1DD - (全角マイナス)
01 区 0x2171 0x8191 0xA1E1 ¢ (全角セント)
01 区 0x2172 0x8192 0xA1F2 £ (全角ポンド)
02 区 0x224C 0x81CA 0xA2CC ¬ (全角 NOT)
F.2 表示可能画像
アプリキャストでは、以下のフォーマットの画像を表示できます。
PNG 8bit CLUT
使用する減色ツールによっては、生成された PNG ファイルが TV 上で正しく表示されないことがあり
ます。
PNG 32bit
JPEG(非プログレッシブ)
アプリキャスト開発ガイド
- 35 –
注注釈釈
※1 モデルによって使用できる機能が異なります。
モデル 対応プロ
ファイル
リモコン
[アプリキャス
ト]ボタン
視聴中オプシ
ョンメニュー
からの起動
アプリの複製 追加情報表示 USB 機能
BRAVIA J3000/5000
シリーズ AC1.0 - - - - -
BRAVIA X7000,
X50x0, W5000,
V3000/5000
シリーズ
AC1.0,
AC1.1
○
(一部機種を
除く)
○ - - -
BRAVIA F1, V1, J1,
M1, JE1 シリーズ
BRAVIA XR1, X1, W1,
ZX1 シリーズ
BRAVIA V5, J5 シリー
ズ
AC1.0,
AC1.1,
AC2.0
○
(一部機種を
除く)
○ ○ ○
○
(USB 端子
搭載機種
のみ)
BRAVIA F5, W5 シリー
ズ
AC1.0,
AC1.1,
AC2.0
○ - ○ ○ ○
※2 アプリに指定するプロファイルによって使用できない場合があります。
※3 入力できる文字数はモデルによって異なります。BRAVIA J3000/5000 では 12 文字、それ以外の機種
では 42 文字。
※4 BRAVIA J3000/5000 シリーズではソフトウエア・キーボードを表示したときに「*」ではなく、設定されて
いるパスワードがそのまま表示されます。
※5 全角/半角が混在する文字列の場合、 後の文字は全角になるようにしてください。
※6 表示可能な文字幅です。