トレイトとハンドラをさらに追加する

トレイトは、必要に応じていくつでもデバイスモデルに追加できます。これらのトレイトは 1 つのデバイスタイプに限定されるものではなく、自由に使うことができます。

トレイトを追加して受信コマンドを処理する手順は次のとおりです。

  1. 追加するトレイトを決定します。

  2. hotword.py ファイルを開きます。

    cd assistant-sdk-python/google-assistant-sdk/googlesamples/assistant/library
    nano hotword.py
  3. action.devices.commands.OnOff コマンドを処理する既存のコードブロックの下に次のコードブロックを追加します(既存のコードブロックは削除しないでください)。

    if command == "action.devices.commands.command-name":
        if params['parameter-name']:
            if conditional:
                print('Something happened.')
            else:
                print('Something else happened.')
    
  4. 上記のコードブロックの各変数に必要な情報を調べます。

    command-nameステップ 1 の特定のトレイトのページ(ColorTemperature など)に移動します。デバイスのコマンドの表にあるコマンドを使用します。
    parameter-nameトレイトページの [Device COMMANDS] 表を再度確認します。各コマンドには 1 つ以上のパラメータが関連付けられています。これらは EXECUTE リクエスト JSON の "params" にリストされます。正確なパラメータ名を使用してください。これらのパラメータの一部は、他のパラメータを含むオブジェクトであるため、トップレベル オブジェクトのみを使用してください。
    conditionalハンドラコードで厳密に条件を使用する必要はありませんが、デバイスでコマンドを実行する方法を区別すると、条件がわかりやすくなる場合があります。

    BrightnessColorTemperature のトレイトの例を次に示します。

    if command == "action.devices.commands.BrightnessAbsolute":
        if params['brightness']:
            if params['brightness'] > 50:
                print('brightness > 50')
            else:
                print('brightness <= 50')
    
    if command == "action.devices.commands.ColorAbsolute":
        if params['color']:
            if params['color'].get('name') == "blue":
                print('The color is blue.')
            else:
                print('The color is not blue.')
    
  5. ステップ 1 で追加したトレイトでデバイスモデルを更新します。

  6. 変更したソースコードを実行します。

    cd assistant-sdk-python/google-assistant-sdk/googlesamples/assistant/library
    python hotword.py --device-model-id my-model
  7. クエリを試します。

    OK Google, 明るさを 65% に設定して。

    OK Google, 青色にして。

次のステップ

カスタム デバイス アクションを登録する