เพิ่มลักษณะเฉพาะและเครื่องจัดการ

คุณเพิ่มลักษณะเฉพาะให้กับรุ่นอุปกรณ์ได้มากเท่าที่ต้องการ ลักษณะเหล่านี้ ไม่ได้เชื่อมโยงกับอุปกรณ์เพียงประเภทเดียว คุณสามารถใช้อุปกรณ์เหล่านั้นได้ตามต้องการ

กระบวนการนี้เป็นกระบวนการเพิ่มลักษณะและจัดการคําสั่งที่เข้ามาใหม่

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	ดูอีกครั้งที่คำสั่งอุปกรณ์ ในหน้าลักษณะเฉพาะ แต่ละคำสั่งมีพารามิเตอร์อย่างน้อย 1 รายการ ที่เกี่ยวข้อง รายชื่อเหล่านี้แสดงภายใต้ "params" ใน EXECUTE ส่งคำขอ 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%

   กำหนดเป็นสีฟ้า

ขั้นตอนถัดไป

ลงทะเบียนการดำเนินการของอุปกรณ์ที่กำหนดเอง