إضافة المزيد من السمات والمعالجات

يمكنك إضافة العديد من السمات إلى طراز جهازك كما تريد. لا ترتبط هذه السمات بنوع واحد فقط من الأجهزة، فيمكنك استخدامها كما تريد.

هذه هي عملية إضافة أي سمة والتعامل مع الأمر الوارد:

  1. حدِّد السمة التي تريد إضافتها.

  2. افتح ملف pushtotalk.py.

    cd assistant-sdk-python/google-assistant-sdk/googlesamples/assistant/grpc
    nano pushtotalk.py
  3. أضِف مجموعة الرموز التالية ضمن المجموعة الحالية التي تعالج الأمر action.devices.commands.OnOff (لا تحذف مجموعة الرموز الحالية).

    @device_handler.command('action.devices.commands.command-name')
    def my-function(parameter-name):
        if conditional:
            logging.info('Something happened.')
        else:
            logging.info('Something else happened.')
    
  4. ابحث عن المعلومات التي تحتاج إليها لكل متغيّر في مجموعة الرموز أعلاه.

    command-nameانتقِل إلى صفحة السمات المحدّدة من الخطوة 1 (على سبيل المثال، ColorTemperature). استخدم أمرًا من الجدول أوامر الجهاز.
    my-functionقم بتسمية دالة معالجك حسب ما تريده.
    parameter-nameانظر مرة أخرى إلى جدول أوامر الأجهزة في صفحة السمات. يتضمن كل أمر معلَمة واحدة أو أكثر مرتبطة به. ويتم إدراج هذه المَعلمات ضمن "params" في تنسيق JSON للطلب "تنفيذ". استخدِم اسم المَعلمة بالضبط. يُرجى العِلم أنّ بعض هذه المعلَمات هي كائنات تحتوي على معلَمات أخرى. ما عليك سوى استخدام كائن المستوى الأعلى.
    conditionalولا يلزمك استخدام شرطية في رمز المعالج، ولكن قد يكون من المفيد التمييز بين طريقة تنفيذ الأمر على الجهاز.

    في ما يلي بعض الأمثلة على السمتين السطوع وColorTemperature:

    @device_handler.command('action.devices.commands.BrightnessAbsolute')
    def brightnessCheck(brightness):
        if brightness > 50:
            logging.info('brightness > 50')
        else:
            logging.info('brightness <= 50')
    
    @device_handler.command('action.devices.commands.ColorAbsolute')
    def color(color):
        if color.get('name') == "blue":
            logging.info('color is blue')
        else:
            logging.info('color is not blue')
    
  5. حدِّث طراز الجهاز باستخدام السمة التي أضفتها في الخطوة 1.

  6. شغِّل رمز المصدر المعدّل.

    cd assistant-sdk-python/google-assistant-sdk/googlesamples/assistant/grpc
    python pushtotalk.py
  7. اضغط على مفتاح Enter وجرِّب إدخال طلب.

    مثال:

    اضبط مستوى السطوع على 65%.

    الاختيار باللون الأزرق:

الخطوة التالية

تسجيل الإجراءات المخصّصة للأجهزة