スキルにイベントを追加する
Alexa Skills Kitコマンドラインインターフェース(ASK CLI)を使ってスキルを開発する場合、イベントサブスクリプションを含めるようにスキルのスキーマを変更できます。これにより、より機能の豊富なスキルや外部アプリを活用したスキルを開発できます。イベントについて詳しくは、スキルイベントとリストイベントを参照してください。
プリビルドおよびカスタムの音声対話モデルは、スキルイベントをサポートします。
既存スキルにイベントを追加するには、以下の手順に従います。ASK CLIから直接リストスキルを新規作成するには、リストスキルの作成手順を参照してください。スキルイベントやリストイベントを使用したスキルのサンプルコードを表示できます。
以下の手順は、カスタムスキル、リストスキルの両方に適用されます。
カスタムスキルのマニフェストがこの方法で更新された場合、スキルイベントを含めることができます。
リストスキルのマニフェストには、以下の2つの形式があります。
- イベントと
apis
オブジェクトに追加のhouseholdList
フィールドを含むカスタムスキルのスキルマニフェストです。 apis
オブジェクトにhouseholdList
フィールドを含むがcustom
オブジェクトは含まれず、対話モデルも含まないスキルマニフェストです。
イベントを処理するコードをスキルサービスに追加する方法については、GitHubのリストイベントデモを参照してください。
ASK CLIをインストールする
スキル定義を更新する前に、ASK CLIをインストールする必要があります。詳細については、Alexa Skills Kitコマンドラインインターフェースクイックスタートガイドを参照してください。
イベントを含めるようスキル定義を更新する
ASK CLIのインストールと初期化が完了したら、以下のように既存スキルのスキル定義を更新できます。
-
get-skill-manifestコマンドを使用して、既存のスキルマニフェストをダウンロードします。
ask smapi get-skill-manifest -s {skillId} -g {development|certified|live} > skill.json
-
events
オブジェクトを含めるようskill.json
ファイルを更新します。詳細については、スキルマニフェストを参照してください。 -
スキルで必要な場合は、スキルの適切なスコープを使用して、
permissionInfo
オブジェクトを追加します。詳細については、スキルマニフェストを参照してください。 -
update-skill-manifestコマンドを使用してスキル定義を更新します。
ask smapi update-skill-manifest -s {skillId} -g {development|certified|live} --manifest "$(cat skill.json)"
Last updated: Oct 22, 2021