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

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

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

  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انظر مرة أخرى إلى جدول أوامر الأجهزة في صفحة السمات. يتضمن كل أمر معلَمة واحدة أو أكثر مرتبطة به. ويتم إدراج هذه المَعلمات ضمن "params" في تنسيق JSON للطلب "تنفيذ". استخدِم اسم المَعلمة بالضبط. يُرجى العِلم أنّ بعض هذه المعلَمات هي كائنات تحتوي على معلَمات أخرى. ما عليك سوى استخدام كائن المستوى الأعلى.
    conditionalولا يلزمك استخدام شرطية في رمز المعالج، ولكن قد يكون من المفيد التمييز بين طريقة تنفيذ الأمر على الجهاز.

    في ما يلي بعض الأمثلة على السمتين السطوع و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. حدِّث طراز الجهاز باستخدام السمة التي أضفتها في الخطوة 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، أريد تغيير لونها إلى الأزرق.

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

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