開発者コンソール

Alexa.Launcherインターフェース


Alexa.Launcherインターフェース

Alexa.Launcherインターフェースは、以下のターゲットを起動するためのディレクティブを提供します。

ターゲットを起動するディレクティブには、定義済みの起動ターゲットのリストにある名前と識別子が含まれます。起動ターゲットのリストを確認して、スキルの機能をサポートするアイテムを、スキルが確実に正しく解決できるようにしてください。

Launcherインターフェースでサポートされているロケールについては、Alexaインターフェースとサポートしている言語の一覧を参照してください。

ディレクティブ

LaunchTarget

指定したアプリまたはショートカットを起動するようリクエストします。ユーザーが指定したアプリまたはショートカットは、定義済みの起動ターゲットのリストにある識別子と照合され、その名前と識別子がリクエストで送信されます。

ユーザー: アレクサ、Prime Videoを起動して

例: Prime Videoを起動する

{
    "directive": {
        "endpoint": {
              "scope": {
                "type": "BearerToken",
                "token": "some-access-token"
              },
              "endpointId": "endpoint-001",
              "cookie": {}
            },
        },
        "header": {
            "correlationToken": "dFMb0z+PgpgdDmluhJ1LddFvSqZ/jCc8pt90jSqg==",
            "messageId": "abc-123-def-456",
            "name": "LaunchTarget",
            "namespace": "Alexa.Launcher",
            "payloadVersion": "3"
        },
        "payload": {
            "identifier": "amzn1.alexa-ask-target.app.72095",
            "name": "Prime Video"
        }
    }
}

ペイロードの詳細

プロパティ 説明 必須
identifier 起動するアイテムの識別子です。アプリの識別子にはapp、ショートカットの識別子にはshortcutが含まれます。識別子のリストについては、起動ターゲットのリファレンスを参照してください。 文字列
name 識別子に関連付けられた名前です。 文字列

イベントとプロパティ

レポート可能なプロパティ

プロパティ名 説明
target Target 起動されるアプリまたはショートカットです。

Response

LaunchTargetディレクティブが正常に処理されたら、Responseを送信します。

レスポンスの例

以下に、Responseメッセージの例を示します。メッセージのコンテキストでtargetプロパティの値をレポートします。

{
    "context": {
        "properties": [
            {
                "name": "target",
                "namespace": "Alexa.Launcher",
                "timeOfSample": "2017-05-06T16:20:50.52Z",
                "uncertaintyInMilliseconds": 0,
                "value": {
                    "identifier": "amzn1.alexa-ask-target.app.72095",
                    "name": "Prime Video"
                }
            }
        ]
    },
    "event": {
        "header": {
            "correlationToken": "dFMb0z+PgpgdDmluhJ1LddFvSqZ/jCc8pt90jSqg==",
            "messageId": "abc-123-def-456",
            "name": "Response",
            "namespace": "Alexa",
            "payloadVersion": "3"
        },
        "payload": {}
    }
}

ErrorResponse

何らかの理由でユーザーのリクエストを完了できない場合は、エラーレスポンスを返す必要があります。詳細については、エラー処理を参照してください。