PlayMediaコマンド

PlayMediaコマンド

ビデオプレーヤーでメディアを再生します。

プロパティ

PlayMediaコマンドには、共通のコマンドプロパティに加えて、以下の表に示すプロパティがあります。typeプロパティはPlayMediaに設定します。

コマンドを実行するために値が必要なプロパティの場合、以下の表の「デフォルト」列に「必須」と表示されています。それ以外の場合はデフォルト値が表示されますが、デフォルト値がないこともあります。

プロパティ 型 必須 説明

audioTrack

background、foreground、none

foreground

再生するオーディオトラックです。デフォルトはforegroundです。

componentId

セレクター

:source

Videoコンポーネントです。

source

URLまたはソースの配列

必須

メディアのソースです。

既にコンテンツを再生しているプレーヤーでPlayMediaコマンドを実行すると、再生中のコンテンツが停止し、すべての既存のソースデータが消去され、新しく取り込まれたソースデータに置き換えられます。このメディアコンテンツは自動的に取り込まれ、再生が始まります。

PlayMediaコマンドの有効期間は、audioTrackで設定します。audioTrackが「foreground」に設定されていると、メディアが再生されている間はPlayMediaコマンドが有効になります。audioTrackが「background」または「none」に設定されていると、PlayMediaコマンドは直ちに制御を返します。たとえば、メディアトラックに続けて音声を読み上げるには、次のように記述します。

{
  "type": "Sequential",
  "items": [
    {
      "type": "PlayMedia",
      "componentId": "myAudioPlayer",
      "source": "http://music.amazon.com/s3/MAGIC_TRACK_HERE",
      "audioTrack": "foreground"
    },
    {
      "type": "SpeakItem",
      "componentId": "mySpokenItem"
    }
  ]
}

上記の場合、SpeakItemコマンドは、メディアトラックの再生が終了した後に実行されます。audioTrackが「background」に設定されている場合、SpeakItemコマンドは、メディアトラックの再生が開始した直後に実行されます。PlayMediaコマンドを早期停止（ユーザーが画面をタッチしたり、Alexaから新しいコマンドを受け取ったりするなど）するアクションは、audioTrackが「foreground」に設定されている場合にのみビデオの再生を停止します。audioTrackが「background」の場合、PlayMediaコマンドは既に終了しているため、何も停止しません。

PlayMediaコマンドは、高速モードでは無視されます。

audioTrack

VideoコンポーネントのaudioTrackプロパティを参照してください。

componentId

Videoコンポーネントを識別するセレクターです。指定しない場合は、デフォルトで:sourceになります。:sourceセレクターは、PlayMediaコマンドを発行したコンポーネントをターゲットにします。

source

sourceプロパティの定義については、Videoを参照してください。

再インフレート時の処理方針

Reinflateコマンドを実行すると、Alexaがドキュメントを再インフレートした後でPlayMediaコマンドを再開できます。PlayMediaコマンドは、次の条件がすべて満たされたときに再開されます。

  • コマンドがReinflateのpreservedSequencers配列で指定されたsequencerで実行されている。
  • VideoコンポーネントのsourceプロパティとplayingStateプロパティが、どちらもVideoコンポーネントのpreserveプロパティで指定されている。
このページは役に立ちましたか？

最終更新日: 2025 年 12 月 04 日