Alexa.PlaybackControllerインターフェース



Alexa.PlaybackControllerインターフェース

Alexa.PlaybackControllerインターフェースは、オーディオコンテンツやビデオコンテンツの再生、停止、再生操作に使用するメッセージを提供します。

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

検出

検出応答でディレクティブを使用する場合、エンドポイントがサポートするディレクティブを指定する必要があります。エンドポイントがサポートする操作は、supportedOperations配列を含めて指定します。

サポートされている値は以下のとおりです。

supportedOperationsを含んだ検出応答の例

{
  "event": {
    "header": {
      "namespace":"Alexa.Discovery",
      "name":"Discover.Response",
      "payloadVersion":"3",
      "messageId":"abc-123-def-456"
    },
    "payload":{
      "endpoints":[
        {
          "capabilities":
          [
            {
              "type": "AlexaInterface",
              "interface": "Alexa.PlaybackController",
              "version": "3",
              "supportedOperations" : ["Play", "Pause", "Stop"]
            }
          ]
        }
      ]
    }
  }
}

ディレクティブ

FastForward

現在のコンテンツを早送りするリクエストです。

英語

ユーザー: Alexa, fast forward on device

German (Deutsche)

ユーザー: Alexa, fast forward on device

French (français)

ユーザー: Alexa, mets en avance rapide l'appareil

リクエストの例

{
  "directive": {
    "header": {
      "namespace": "Alexa.PlaybackController",
      "name": "FastForward",
      "messageId": "abc-123-def-456",
      "payloadVersion": "3"
    },
    "endpoint": {
      "scope": {
        "type": "BearerToken",
        "token": "access-token-from-skill"
      },
      "endpointId": "device-001",
      "cookie": {

      }
    },
    "payload": {
    }
  }
}

ペイロードの詳細

フィールド 説明 タイプ 必須
なし ペイロードに必須または任意のフィールドはありません。 なし なし

Next

再生コンテンツの次の項目に移動するリクエストです。

英語

ユーザー: Alexa, next song/video/photo on device
ユーザー: Alexa, go forward on device

German (Deutsche)

ユーザー: Alexa, next song/video/photo on device
ユーザー: Alexa, go forward on device

French (français)

ユーザー: Alexa, mets la chanson/la video/la photo suivante sur l'appareil
ユーザー: Alexa, mets en avance rapide sur l'appareil

リクエストの例

{
  "directive": {
    "header": {
      "namespace": "Alexa.PlaybackController",
      "name": "Next",
      "messageId": "abc-123-def-456",
      "payloadVersion": "3"
    },
    "endpoint": {
      "scope": {
        "type": "BearerToken",
        "token": "access-token-from-skill"
      },
      "endpointId": "device-001",
      "cookie": {

      }
    },
    "payload": {
    }
  }
}

ペイロードの詳細

フィールド 説明 タイプ 必須
なし ペイロードに必須または任意のフィールドはありません。 なし なし

Pause

オーディオまたはビデオコンテンツの再生を一時停止するリクエストです。

英語

ユーザー: Alexa, pause device

German (Deutsche)

ユーザー: Alexa, pause device

French (français)

ユーザー: Alexa, pause l'appareil

リクエストの例

{
  "directive": {
    "header": {
      "namespace": "Alexa.PlaybackController",
      "name": "Pause",
      "messageId": "abc-123-def-456",
      "payloadVersion": "3"
    },
    "endpoint": {
      "scope": {
        "type": "BearerToken",
        "token": "access-token-from-skill"
      },
      "endpointId": "device-001",
      "cookie": {

      }
    },
    "payload": {}
  }
}

ペイロードの詳細

フィールド 説明 タイプ 必須
なし ペイロードに必須または任意のフィールドはありません。 なし なし

Play

オーディオまたはビデオコンテンツを再生または再開するリクエストです。

英語

ユーザー: Alexa, resume device
ユーザー: Alexa, play device

German (Deutsche)

ユーザー: Alexa, resume device
ユーザー: Alexa, play device

French (français)

ユーザー: Alexa, Remets lecture sur l'appareil
ユーザー: Alexa, mets lecture sur l'appareil

リクエストの例

{
  "directive": {
    "header": {
      "namespace": "Alexa.PlaybackController",
      "name": "Play",
      "messageId": "abc-123-def-456",
      "payloadVersion": "3"
    },
    "endpoint": {
      "scope": {
        "type": "BearerToken",
        "token": "access-token-from-skill"
      },
      "endpointId": "device-001",
      "cookie": {
      }
    },
    "payload": {
    }
  }
}

ペイロードの詳細

フィールド 説明 タイプ 必須
なし ペイロードに必須または任意のフィールドはありません。 なし なし

Previous

再生コンテンツの前の項目に移動するリクエストです。

英語

ユーザー: Alexa, previous on device

German (Deutsche)

ユーザー: Alexa, go back on device

French (français)

ユーザー: Alexa, chaîne précédente

リクエストの例

{
  "directive": {
    "header": {
      "namespace": "Alexa.PlaybackController",
      "name": "Previous",
      "messageId": "abc-123-def-456",
      "payloadVersion": "3"
    },
    "endpoint": {
      "scope": {
        "type": "BearerToken",
        "token": "access-token-from-skill"
      },
      "endpointId": "device-001",
      "cookie": {

      }
    },
    "payload": {
    }
  }
}

ペイロードの詳細

フィールド 説明 タイプ 必須
なし ペイロードに必須または任意のフィールドはありません。 なし なし

Rewind

現在のコンテンツを早戻しするリクエストです。

英語

ユーザー: Alexa, rewind on device

German (Deutsche)

ユーザー: Alexa, rewind on device

French (français)

ユーザー: Alexa, reviens en arrière sur l'appareil

リクエストの例

{
  "directive": {
    "header": {
      "namespace": "Alexa.PlaybackController",
      "name": "Rewind",
      "messageId": "c8d53423-b49b-48ee-9181-f50acedf2870",
      "payloadVersion": "3"
    },
    "endpoint": {
      "scope": {
        "type": "BearerToken",
        "token": "access-token-from-skill"
      },
      "endpointId": "device-001",
      "cookie": {

      }
    },
    "payload": {
    }
  }
}

ペイロードの詳細

フィールド 説明 タイプ 必須
なし ペイロードに必須または任意のフィールドはありません。 なし なし

StartOver

オーディオまたはビジュアルコンテンツを最初から再生するリクエストです。

英語

ユーザー: Alexa, start over on device

German (Deutsche)

ユーザー: Alexa, gerät neustarten

French (français)

ユーザー: Alexa, reprends la lecture sur l'appareil

リクエストの例

{
  "directive": {
    "header": {
      "namespace": "Alexa.PlaybackController",
      "name": "StartOver",
      "messageId": "abc-123-def-456",
      "payloadVersion": "3"
    },
    "endpoint": {
      "scope": {
        "type": "BearerToken",
        "token": "access-token-from-skill"
      },
      "endpointId": "device-001",
      "cookie": {

      },
      "payload": {}
    }
  }
}

ペイロードの詳細

フィールド 説明 タイプ 必須
なし ペイロードに必須または任意のフィールドはありません。 なし なし

Stop

オーディオまたはビデオコンテンツの再生を停止するリクエストです。

英語

ユーザー: Alexa, stop device

German (Deutsche)

ユーザー: Alexa, stop device

French (français)

ユーザー: Alexa, arrête l'appareil

リクエストの例

{
  "directive": {
    "header": {
      "namespace": "Alexa.PlaybackController",
      "name": "Stop",
      "messageId": "abc-123-def-456",
      "payloadVersion": "3"
    },
    "endpoint": {
      "scope": {
        "type": "BearerToken",
        "token": "access-token-from-skill"
      },
      "endpointId": "device-001",
      "cookie": {

      }
    },
    "payload": {
    }
  }
}

ペイロードの詳細

フィールド 説明 タイプ 必須
なし ペイロードに必須または任意のフィールドはありません。 なし なし

プロパティとイベント

この機能では、以下のように応答する必要があります。

  • 同期的に応答します。つまり、Lambda関数からAlexaに応答を送信します。

応答を送信する場合、メッセージのcontextにインターフェースのプロパティの状態を含める必要があります。

プロパティ

現時点では、Alexa.PlaybackControllerインターフェースに定義されている出力プロパティはありません。

応答

このインターフェースのいずれかのディレクティブが正常に完了した場合、応答イベントを送信する必要があります。

応答の例

{
  "context": {
    "properties": []
  },
  "event": {
    "header": {
      "messageId": "abc-123-def-456",
      "namespace": "Alexa",
      "name": "Response",
      "payloadVersion": "3"
    },
    "endpoint":{
       "endpointId":"appliance-001"
    },
    "payload":{ }
 }
}

ErrorResponse

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

その他のサンプルコード

リクエストと応答のサンプルについては、AlexaスマートホームのGitHubリポジトリで以下を参照してください。

PlaybackController

インターフェース 説明
Alexa.RemoteVideoPlayer コンテンツの検索と再生を行うディレクティブを提供します。
Alexa.PlaybackStateReporter 再生エンドポイントの状態をレポートするイベントを提供します。