スキルにイベントを追加する



スキルにイベントを追加する

ASK CLI(Alexa Skills Kitコマンドラインインターフェース)を使ってスキルを開発する場合、イベントサブスクリプションを含めるようにスキルのスキーマを変更できます。これにより、より機能の豊富なスキルや外部アプリを活用したスキルを開発できます。イベントについて詳しくは、スキルイベントリストイベントを参照してください。

カスタムスキルやスマートホームスキルなどすべてのスキルモデルは、スキルイベントをサポートします。

既存スキルにイベントを追加するには、以下の手順に従います。ASK CLIから直接リストスキルを新規作成するには、リストスキルの作成手順を参照してください。スキルイベントやリストイベントを使用したスキルのサンプルコードを表示できます。

以下の手順は、カスタムスキル、リストスキルの両方に適用されます。

カスタムスキルのマニフェストがこの方法で更新された場合、スキルイベントを含めることができます。

リストスキルのマニフェストには、以下の2つの形式があります。

  • イベントとapisオブジェクトに追加のhouseholdListフィールドを含むカスタムスキルのスキルマニフェストです。
  • apisオブジェクトにhouseholdListフィールドを含むがcustomオブジェクトは含まれず、対話モデルも含まないスキルマニフェストです。

イベントを処理するコードをスキルサービスに追加する方法については、GitHubのリストイベントデモを参照してください。

ASK CLIをインストールする

スキル定義を更新する前に、ASK CLIをインストールする必要があります。詳細については、Alexa Skills Kitコマンドラインインターフェースクイックスタートガイドを参照してください。

イベントを含めるようスキル定義を更新する

ASK CLIのインストールと初期化が完了したら、以下のように既存スキルのスキル定義を更新できます。

  1. get-skill-manifestコマンドを使用して、既存のスキルマニフェストをダウンロードします。

    ask smapi get-skill-manifest -s {skillId} -g {development|certified|live} > skill.json

  2. eventsオブジェクトを含めるようskill.jsonファイルを更新します。詳細については、スキルマニフェストを参照してください。

  3. スキルで必要な場合は、スキルの適切なスコープを使用して、permissionInfoオブジェクトを追加します。詳細については、スキルマニフェストを参照してください。

  4. update-skill-manifestコマンドを使用してスキル定義を更新します。

    ask smapi update-skill-manifest -s {skillId} -g {development|certified|live} --manifest skill.json