Notificationsインターフェース



このインターフェースでは、Alexaドメインまたは有効なAlexaスキルから新しいコンテンツが提供されていることを、ガジェットからユーザーに通知できます。このインターフェースは、ユーザーへの視覚および音声インジケーターを設定および消去するようガジェットに指示する2つのディレクティブを提供します。

このインターフェースでは、通知の内容は指定しません。新しいコンテンツが利用可能であることをユーザーに通知するためにガジェットで使用できる、視覚および音声インジケーターとしてのみ機能します。たとえば、ユーザーが「アレクサ、何か通知はある？」と言って保留中の通知を取得する場合、ガジェットは黄色のLEDを点滅させ、音声ファイルを再生します。

• このインターフェースのサポート
• ディレクティブ
  • SetIndicatorディレクティブ
    • SetIndicatorDirectiveProto
    • Directive
    • DirectiveHeaderProto
    • SetIndicatorDirectivePayloadProto
    • Asset
  • ClearIndicatorディレクティブ
    • ClearindicatorDirectiveProto
    • Directive
    • DirectiveHeaderProto
    • ClearindicatorDirectivePayloadProto

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

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

{
   "type": "AlexaInterface",
   "interface": "Notifications",
   "version": "1.0"
}

ディレクティブ

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

SetIndicatorディレクティブ

通知がある場合に視覚および音声インジケーターを出力するよう、ガジェットに指示するディレクティブです。.protoファイルの記述は次のとおりです。

message SetIndicatorDirectiveProto {
   Directive directive = 1;
   message Directive {
      notifications.SetIndicatorDirectivePayloadProto payload = 2;
      header.DirectiveHeaderProto header = 1;
   }
}

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

message SetIndicatorDirectivePayloadProto {
   bool persistVisualIndicator = 1;
   bool playAudioIndicator = 2;
   Asset asset = 3;
   message Asset {
      string assetId = 1;
      string url = 2;
   }
}

SetIndicatorDirectiveProto

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

Directive

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

DirectiveHeaderProto

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

SetIndicatorDirectivePayloadProto

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

Asset

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

ClearIndicatorディレクティブ

有効な視覚および音声インジケーターをすべて消去するよう、ガジェットに指示するディレクティブです。.protoファイルの記述は次のとおりです。

message ClearIndicatorDirectiveProto {
   Directive directive = 1;
   message Directive {
      notifications.ClearIndicatorDirectivePayloadProto payload = 2;
      header.DirectiveHeaderProto header = 1;
   }
}

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

message ClearindicatorDirectivePayloadProto {
}

ClearindicatorDirectiveProto

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

Directive

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

DirectiveHeaderProto

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

ClearindicatorDirectivePayloadProto

このメッセージにはフィールドがありません。