Alexa.Gadget.MusicDataインターフェース（ベータ）



このインターフェースは、Echoデバイスで再生しているAmazon Musicのテンポデータをガジェットに送信します。このインターフェースはAmazon Musicでのみ動作します。その他の音楽サービスプロバイダーはサポートしていません。

ガジェットがこのインターフェースをサポートしている場合は、1曲につきTempoディレクティブを2つ受信します。1つは曲の先頭に、もう1つは曲の終わりに受信します。曲の先頭に提供されるテンポデータは、曲の1分あたりの平均拍数です。曲の終わりに提供されるテンポデータはゼロで、曲が終了したことを示します。

Amazon Musicがミュートになっている場合でも、テンポデータはガジェットに送信されます。

• このインターフェースのサポート
• ディレクティブ
  • Tempoディレクティブ
    • TempoDirectiveProto
    • Directive
    • DirectiveHeaderProto
    • TempoDirectivePayloadProto
    • TempoData

このインターフェースのサポート

このインターフェースをサポートするには、Capabilitiesの配列に以下のエントリを含むDiscover.Responseイベントを使用して、EchoデバイスのDiscoverディレクティブにガジェットから応答を返す必要があります。

{
   "type": "AlexaInterface",
   "interface": "Alexa.Gadget.MusicData",
   "version": "1.0",
   "configurations": {
      "supportedTypes":[
       {
          "name":"tempo"
       }
      ]
    }
}

ディレクティブ

このインターフェースには、以下に説明する1つのディレクティブ （Tempo）が含まれます。

Tempoディレクティブ

このディレクティブは、ガジェットに音楽のテンポを提供します。.protoファイルの記述は次のとおりです。

message TempoDirectiveProto {
   Directive directive = 1;
   message Directive {
      alexaGadgetMusicData.TempoDirectivePayloadProto payload = 2;
      header.DirectiveHeaderProto header = 1;
   }
}

message DirectiveHeaderProto {
   string namespace = 1; 
   string name = 2; 
   string messageId = 3; 
   string dialogRequestId = 4;      
}

message TempoDirectivePayloadProto {
   int32 playerOffsetInMilliseconds = 1;
   repeated TempoData tempoData = 2;
   message TempoData {
      int32 startOffsetInMilliseconds = 2;
      int32 value = 1;
   }
}

TempoDirectiveProto

このメッセージのフィールドは次のとおりです。

Directive

このメッセージのフィールドは次のとおりです。

DirectiveHeaderProto

このメッセージのフィールドは次のとおりです。

TempoDirectivePayloadProto

このメッセージのフィールドは次のとおりです。

TempoData

このメッセージのフィールドは次のとおりです。