Ajouter d'autres caractéristiques et gestionnaires

<ph type="x-smartling-placeholder">

Vous pouvez ajouter autant de caractéristiques que vous le souhaitez au modèle de votre appareil. Ces caractéristiques sont non liés à un seul type d'appareil, vous pouvez les utiliser comme vous le souhaitez.

Voici le processus permettant d'ajouter une caractéristique et de gérer la commande entrante:

  1. Déterminer la caractéristique souhaitée à ajouter.

  2. Ouvrez le fichier hotword.py.

    cd assistant-sdk-python/google-assistant-sdk/googlesamples/assistant/library
    nano hotword.py
  3. Ajoutez le bloc de code suivant sous le bloc existant gère la commande action.devices.commands.OnOff (ne supprimez pas la clé existante bloc de code).

    if command == "action.devices.commands.command-name":
        if params['parameter-name']:
            if conditional:
                print('Something happened.')
            else:
                print('Something else happened.')
    
  4. Retrouvez les informations dont vous avez besoin pour chaque variable dans le bloc de code ci-dessus.

    command-nameAccédez à la page de la caractéristique spécifique Étape 1 (par exemple, ColorTemperature) Utilisez une commande du tableau Commandes relatives à l'appareil.
    parameter-nameConsultez de nouveau les commandes Device COMMANDS sur la page des caractéristiques. Chaque commande comporte un ou plusieurs paramètres qui lui est associée. Ils sont répertoriés sous "params" dans EXECUTE requête JSON. Utilisez le nom exact du paramètre. Notez que certains de ces sont des objets qui contiennent d'autres paramètres. Il vous suffit d'utiliser objet de premier niveau.
    conditionalIl n'est pas nécessaire d'utiliser strictement dans le code de votre gestionnaire, mais cela peut vous aider à différencier la façon dont vous exécutez sur l'appareil.

    Voici quelques exemples de caractéristiques Luminosité et ColorTemperature:

    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. Modifier le modèle de l'appareil avec la caractéristique que vous avez ajoutée à l'étape 1.

  6. Exécutez le code source modifié.

    cd assistant-sdk-python/google-assistant-sdk/googlesamples/assistant/library
    python hotword.py --device-model-id my-model
  7. Essayez une requête.

    Hey Google, règle la luminosité sur 65%.

    Ok Google, mets la couleur bleue.

Étape suivante

Enregistrer des actions personnalisées sur l'appareil