ویژگی ها و کنترل کننده های بیشتری را اضافه کنید

شما می توانید هر تعداد ویژگی که می خواهید به مدل دستگاه خود اضافه کنید. این ویژگی‌ها تنها به یک نوع دستگاه مرتبط نیستند، می‌توانید هر طور که می‌خواهید از آنها استفاده کنید.

این فرآیند برای افزودن هر صفت و مدیریت دستور ورودی است:

  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 ). از یک دستور از جدول Device COMMANDS استفاده کنید.
    parameter-name دوباره به جدول Device COMMANDS در صفحه ویژگی نگاه کنید. هر دستور دارای یک یا چند پارامتر مرتبط با آن است. اینها در زیر "params" در JSON درخواست EXECUTE فهرست شده اند. از نام پارامتر دقیق استفاده کنید. توجه داشته باشید که برخی از این پارامترها اشیایی هستند که حاوی پارامترهای دیگری هستند - فقط از شی سطح بالا استفاده کنید.
    conditional شما به شدت نیازی به استفاده از یک شرطی در کد کنترل کننده خود ندارید، اما ممکن است به تمایز نحوه اجرای دستور در دستگاه کمک کند.

    در اینجا چند مثال برای صفات روشنایی و دمای رنگ آورده شده است:

    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. مدل دستگاه را با ویژگی‌ای که در مرحله ۱ اضافه کرده‌اید به‌روزرسانی کنید .

  6. کد منبع اصلاح شده را اجرا کنید.

    cd assistant-sdk-python/google-assistant-sdk/googlesamples/assistant/library
    python hotword.py --device-model-id my-model
  7. یک پرس و جو را امتحان کنید.

    Hey Google، روشنایی را روی 65٪ تنظیم کنید.

    اوکی گوگل، آن را آبی کنید.

مرحله بعدی

ثبت اقدامات دستگاه سفارشی