DIALの有効化
マニフェストの更新
Vega上で、アプリケーションまたはパッケージがDIALをサポートしていることをDIALが検出できるようにするには、manifest.tomlファイルに以下を追加する必要があります。dial_idは、https://www.dial-multiscreen.org/dial-registries/about-the-registryにあるDIALレジストリで選択して登録したアプリ名です。- これは、Fire OSベースの実装で使用されたwhisperplay.xmlファイル内の「dialid」と同じです。
- dial_launch_componentは、DIALが起動するパッケージ内の対話型コンポーネントです。DIALから起動URIが送信されるとき、その形式は次のようになります：* pkg://<dial_launch_component>?<DIAL POSTリクエストのペイロード>&DIAL_ADDITIONAL_DATA_URL=http://127.0.0.1:8009/apps/<Dial ID>/dial_data
（任意）<authorizedOrigins>によるCORSのサポート
CORS認証とクライアントオリジンに関する追加要件の詳細については、DIAL spec v2.2.1, section 6.6（英語のみ）を参照してください。Amazonの実装では、ファーストスクリーンアプリのwhisperplay.xmlファイル内で、許可されるCORSオリジンのコレクションを指定する必要があります（上記の例を参照）。この形式では、0文字以上の文字列に一致する「*」文字を使用したワイルドカード一致が許可されています。特定の安全でないURIスキーム（file:、http:、ftp:など）は、許可リストへの登録の有無を問わず、明示的に禁止されています。
許可されるオリジンを指定する場合は、過度に許容しないよう注意してください。たとえば、https://test.amazon.comとhttps://amazon.comの両方を許可する場合、許可されるオリジンを*amazon.comとして指定することは避けてください。これは過度な許容であり、予期しないオリジン（https://evilamazon.comなど）が誤って許可されてしまう恐れがあります。このような場合は、代わりにコレクションを以下のように定義することで、所有するドメインに基づくオリジンだけが確実に許可されるようにすることができます。
CORSをサポートするには、manifest.tomlに以下を追加します。
起動とadditionalDataUrlの処理
アプリがDIALペイロード（DIAL起動リクエストを介してアプリに渡される情報）を受信するように設定されている場合、このペイロードは、起動URIのパラメーターとして配信されます。オプションで追加情報をPOSTするためにファーストスクリーンアプリによって使用されるadditionalDataUrlは、起動URIの別のパラメーターとして配信されます。その形式は次のようになります：pkg://<dial_launch_component>?<DIAL POSTリクエストのペイロード>&DIAL_ADDITIONAL_DATA_URL=http://127.0.0.1:8009/apps/<Dial ID>/dial_data。additionalDataUrlの想定される形式はで、このURLにファーストスクリーンアプリからデータがPOSTされます。
（任意）追加データのPOST
ごく基本的な双方向通信や、ファーストスクリーンアプリからセカンドスクリーンアプリへのシンプルなフィードバックメカニズムを有効にする場合は、DIALのadditionalDataUrlフィールドを使用できます。この一般的なユースケースとしては、セッショントークンなどの情報をファーストスクリーンアプリの状態に関連付けて共有するケースが挙げられます。これは、ファーストスクリーンアプリからセカンドスクリーンアプリに提供され、Fire TVが再起動されるまで保持されるXMLドキュメントと考えることができます。Fire TV対応アプリからadditionalDataUrlへのPOSTが正常に実行されるようにするには、対応するオリジンがmanifest.toml内のdial_originsエクストラに登録されている必要があります。
ファーストスクリーンアプリとセカンドスクリーンアプリの両方の追加データメカニズムで想定および提供される具体的な形式については、DIAL docs v2.2.1, section 6.3（英語のみ）を参照してください。
セカンドスクリーンアプリの変更
セカンドスクリーンアプリには、以下に示す変更を加える必要があります。手順A：DIAL対応デバイス検出サービスを実装する
セカンドスクリーンアプリ（DIALクライアント）に、DIALプロトコルのクライアント仕様を実装します。DIALの検出は、UPnP/SSDPの仕様に基づいて構築されています。バックグラウンドアクティビティまたはスレッドで、検索ターゲットを「"urn:dial-multiscreen-org:service:dial:1"」と指定して、UDP M-SEARCHリクエストを送信します。
M-SEARCHリクエストに対し、Fire TVから、一意のサービス名（USN）、デバイス情報を取得する場所／URL、検索ターゲットを含むレスポンスが返されます。さらにこのレスポンスには、追加のWAKEUPヘッダーが含まれる場合もあります。これは、マジックパケットを使用してサスペンドモードからウェイクアップできる機能がTVに現在備わっていることを示すものです。詳細については、DIAL 2.2.1 spec, section 7（英語のみ）を参照してください。デバイスから複数のM-SEARCHレスポンスを受信することもあるため、USNに基づいて一意のデバイスを抽出する必要があります。
以下は、リクエストとレスポンスの例です。
M-SEARCHリクエストの例：
Application-URLという重要な属性が含まれます。これは、DIAL RESTサービスと呼ばれます。このApplication-URLは、後でデバイス上のアプリとのやり取りに使用されます。レスポンス本文から、デバイスの通称、モデル名、製造元を抽出して格納し、これらの値をユーザーに表示すると便利です。
M-SEARCHリクエストとデバイス情報リクエストの処理が完了したら、検出されたデバイスのリストをUIに表示できます。
手順B：アプリのステータスを取得する
デバイスでアプリを起動する前に、デバイスでのアプリの状態を知っておく（さらに必要に応じてadditionalDataを読み取り、キャッシュされた情報をファーストスクリーンアプリから読み込んでおく）と便利です。アプリの状態を取得するには、アプリを起動するデバイスをユーザーが選択したら、アプリ名をリソース名として指定して、HTTP GETリクエストをDIAL RESTサービスに送信します。リクエスト内のアプリ名は、DIALレジストリに登録（かつwhisperplay.xmlファイルで指定）されている名前と一致する必要があります。
アプリがインストールされていない場合や、アプリ名が認識されない場合は、HTTP 404エラーが返されます。ファーストスクリーンデバイスにAmazonアプリストアからアプリをインストールするオプションを、セカンドスクリーンデバイス上でユーザーに提示できますが、この機能はDIALプロトコルの範囲外です。
HTTPリクエストが成功すると、DIALサーバーはHTTP 200 OKレスポンスで応答します。レスポンス本文には、アプリの状態を伝える属性（hidden、stopped、running、installable）が含まれています（ただし、installableとhiddenは現在Fire TVのDIALサーバーではサポートされていません）。また、以前ファーストスクリーンアプリからadditionalDataUrlにPOSTされていたXML形式のadditionalDataも含まれています。
