あなたのAlexaダッシュボード 設定

PlaybackControllerインターフェースのリファレンス

PlaybackControllerインターフェースは、ユーザーが端末上またはリモコン上のボタンなどのプレーヤーコントロールを操作したときにスキルに通知を行うためのリクエストを提供します。スキルは、これらのリクエストに対し、AudioPlayerディレクティブを使用して応答し、再生の開始と停止を行うことができます。

PlaybackControllerインターフェースには、ディレクティブはありません。

PlaybackControllerリクエスト

PlaybackController は、スキルに再生コントロールイベントを通知するために次のリクエストを送信します。

リクエストタイプ 説明
PlaybackController.NextCommandIssued ユーザーが次のオーディオアイテムにスキップするために「次へ」ボタンを使用した場合に送信されます。
PlaybackController.PauseCommandIssued ユーザーが再生を停止するために「一時停止」ボタンを使用した場合に送信されます。
PlaybackController.PlayCommandIssued ユーザーが再生を開始また再開するために「再生」または「再開」ボタンを使用した場合に送信されます。
PlaybackController.PreviousCommandIssued ユーザーが前のオーディオアイテムに戻るために「前へ」ボタンを使用した場合に送信されます。
{
  "version": "string",
  "context": {
    "System": {
      "application": {},
      "user": {},
      "device": {}
    },
    "AudioPlayer": {
      "token": "string",
      "offsetInMilliseconds": 0,
      "playerActivity": "string"
    }
  },
  "request": {
    "type": "PlaybackController.NextCommandIssued",
    "requestId": "string",
    "timestamp": "string",
    "locale": "string"
  }
}

完全なリクエストのフォーマットについては、カスタムスキル用JSONインターフェースリファレンスリクエストのフォーマットを参照してください。

NextCommandIssuedリクエスト

ユーザーが次のオーディオアイテムにスキップするために「次へ」ボタンを使用した場合に送信されます。

{
  "type": "PlaybackController.NextCommandIssued",
  "requestId": "string",
  "timestamp": "string",
  "locale": "string"
}

パラメーター

パラメーター 説明
type PlaybackController.NextCommandIssued string
requestId 特定のリクエストの固有IDを表します。 string
timestamp ISO 8601形式で表された文字列で、Alexaがリクエストを送信した日時を提供します。スキルをウェブサービスとしてホスティングしている場面において、リクエストを検証するために使用されます。 string
locale ユーザーのロケールを示すstringです。例: en-US string

有効な応答タイプ

スキルは、NextCommandIssuedに対して、どのAudioPlayerディレクティブでも応答できます。

応答に以下を含めることはできません。

  • outputSpeechcardrepromptなどの標準のプロパティ。
  • Dialogディレクティブなど、他のインターフェースからの他の任意のディレクティブ。

PauseCommandIssuedリクエスト

ユーザーが再生を停止するために「一時停止」ボタンを使用した場合に送信されます。

{
  "type": "PlaybackController.PauseCommandIssued",
  "requestId": "string",
  "timestamp": "string",
  "locale": "string"
}

パラメーター

パラメーター 説明
type PlaybackController.PauseCommandIssued string
requestId 特定のリクエストの固有IDを表します。 string
timestamp ISO 8601形式で表された文字列で、Alexaがリクエストを送信した日時を提供します。スキルをウェブサービスとしてホスティングしている場面において、リクエストを検証するために使用されます。 string
locale ユーザーのロケールを示すstringです。例: en-US string

有効な応答タイプ

スキルは、PauseCommandIssuedに対して、どのAudioPlayerディレクティブでも応答できます。

応答に以下を含めることはできません。

  • outputSpeechcardrepromptなどの標準のプロパティ。
  • Dialogディレクティブなど、他のインターフェースからの他の任意のディレクティブ。

PlayCommandIssuedリクエスト

ユーザーが再生を開始また再開するために「再生」または「再開」ボタンを使用した場合に送信されます。

{
  "type": "PlaybackController.PlayCommandIssued",
  "requestId": "string",
  "timestamp": "string",
  "locale": "string"
}

パラメーター

パラメーター 説明
type PlaybackController.PlayCommandIssued string
requestId 特定のリクエストの固有IDを表します。 string
timestamp ISO 8601形式で表された文字列で、Alexaがリクエストを送信した日時を提供します。スキルをウェブサービスとしてホスティングしている場面において、リクエストを検証するために使用されます。 string
locale ユーザーのロケールを示すstringです。例: en-US string

有効な応答タイプ

スキルは、PlayCommandIssuedに対して、どのAudioPlayerディレクティブでも応答できます。

応答に以下を含めることはできません。

  • outputSpeechcardrepromptなどの標準のプロパティ。
  • Dialogディレクティブなど、他のインターフェースからの他の任意のディレクティブ。

PreviousCommandIssuedリクエスト

ユーザーが前のオーディオアイテムに戻るために「前へ」ボタンを使用した場合に送信されます。

{
  "type": "PlaybackController.PreviousCommandIssued",
  "requestId": "string",
  "timestamp": "string",
  "locale": "string"
}

パラメーター

パラメーター 説明
type PlaybackController.PreviousCommandIssued string
requestId 特定のリクエストの固有IDを表します。 string
timestamp ISO 8601形式で表された文字列で、Alexaがリクエストを送信した日時を提供します。スキルをウェブサービスとしてホスティングしている場面において、リクエストを検証するために使用されます。 string
locale ユーザーのロケールを示すstringです。例: en-US string

有効な応答タイプ

スキルは、PreviousCommandIssuedに対して、どのAudioPlayerディレクティブでも応答できます。

応答に以下を含めることはできません。

  • outputSpeechcardrepromptなどの標準のプロパティ。
  • Dialogディレクティブなど、他のインターフェースからの他の任意のディレクティブ。

System.ExceptionEncounteredリクエスト

PlaybackControllerリクエストに対する応答によりエラーが発生した場合、System.ExceptionEncounteredリクエストがスキルに送信されます。応答に含まれるディレクティブはすべて無視されます。

{
  "type": "System.ExceptionEncountered",
  "requestId": "string",
  "timestamp": "string",
  "locale": "string",
  "error": {
    "type": "string",
    "message": "string"
  },
  "cause": {
    "requestId": "string"
  }
}

パラメーター

パラメーター 説明
type System.ExceptionEncountered string
requestId 特定のリクエストの固有IDを表します。 string
timestamp ISO 8601形式で表された文字列で、Alexaがリクエストを送信した日時を提供します。スキルをウェブサービスとしてホスティングしている場面において、リクエストを検証するために使用されます。 string
locale ユーザーのロケールを示すstringです。例: en-US string
error エラー情報を持つオブジェクトが含まれています。 object
error.type 特定のタイプのエラー(INVALID_RESPONSEDEVICE_COMMUNICATION_ERRORINTERNAL_ERROR)を識別します。 string
error.message 端末で発生したエラーの説明です。 string
cause.requestId エラーの原因となったリクエストのrequestIdです。 string

有効な応答タイプ

スキルは、System.ExceptionEncounteredに応答を返すことはできません。

サービスインターフェースのリファレンス(JSON)

インターフェース: