ภาพรวมของ Automation API ใน Android

การทำงานอัตโนมัติเป็นวิธีทำให้การตั้งค่าอุปกรณ์และงานต่างๆ ในบ้านเป็นแบบอัตโนมัติ การทำงานอัตโนมัติพร้อมให้บริการในระบบนิเวศของ Google Home ในรูปแบบกิจวัตรในGoogle Home app (GHA)และผ่านautomation script editorในGoogle Home for web

ตอนนี้การทำงานอัตโนมัติในระบบนิเวศของ Google Home พร้อมใช้งานผ่าน Home API สำหรับ Android แล้ว โดยใช้แนวคิดพื้นฐานเดียวกันกับที่ใช้ในGHAกิจวัตรและscript editor แต่มี ฟีเจอร์และความสามารถที่ได้รับการปรับปรุงซึ่งทำได้ผ่าน Home API เท่านั้น ซึ่งรวมถึง

  • สิทธิ์เข้าถึงลักษณะมาตรฐานและลักษณะ Matter ทั้งหมดของอุปกรณ์ตามที่แสดงใน Home APIsmart home
  • รองรับโฟลว์การดำเนินการแบบลำดับ แบบขนาน และแบบเลือก

การทำงานอัตโนมัติเขียนขึ้นโดยใช้ Automation DSL ซึ่งเป็นภาษาเฉพาะของโดเมน ที่ออกแบบมาเพื่อสร้างการทำงานอัตโนมัติใน Kotlin

ต้องลงทะเบียนลักษณะและประเภทใดก็ตามที่คุณตั้งใจจะใช้ในแอปกับ Device & Structure หรือ Automation API เมื่อเริ่มต้น ดูเริ่มต้นใช้งานบ้านบน Android

คำแนะนำในกรณีที่ผู้ใช้เพิกถอนสิทธิ์เต็ม

หากผู้ใช้เพิกถอนสิทธิ์แบบเต็ม การทำงานอัตโนมัติที่มีอยู่ทั้งหมดจะหยุดทำงาน นอกจากนี้ หากผู้ใช้เพิกถอนสิทธิ์เข้าถึงอุปกรณ์ที่เฉพาะเจาะจง เงื่อนไขเริ่มต้น เงื่อนไข และการดำเนินการที่เชื่อมโยงกับอุปกรณ์เหล่านั้นจะ หยุดทำงาน

ทุกครั้งที่แอปเริ่มทำงาน ให้ตรวจสอบว่าสิทธิ์ ยังคงมีผลอยู่ หากมีการเพิกถอนแล้ว โปรดตรวจสอบว่าได้นำข้อมูลก่อนหน้านี้ทั้งหมดออกแล้ว รวมถึงข้อมูลที่แคชไว้ในแอปพลิเคชันด้วย

เมื่อเพิกถอนสิทธิ์เข้าถึงบ้าน ระบบจะส่ง StructureAccessRevokedEvent ไปยังแบ็กเอนด์ระบบคลาวด์ของคุณ ดูการให้สิทธิ์ตามโครงสร้างสำหรับ เวิร์กโฟลว์การเพิกถอนสิทธิ์เข้าถึงระบบคลาวด์และแอปบนอุปกรณ์เคลื่อนที่ของพาร์ทเนอร์ตั้งแต่ต้นจนจบ

เส้นทางของนักพัฒนาแอป

Automation API เป็นส่วนหนึ่งของการเดินทางเพื่อการพัฒนาที่ใหญ่ขึ้น โดยจะเกิดขึ้นหลังจากผสานรวม API โครงสร้างและอุปกรณ์เพื่อให้มั่นใจว่าเมื่อผู้ใช้ต้องการใช้ระบบอัตโนมัติ ก็จะทำได้

  1. นักพัฒนาซอฟต์แวร์วางแผนการทำงานอัตโนมัติและกำหนดโดยใช้ Automation DSL
  2. นักพัฒนาแอปจะฝังคำจำกัดความการทำงานอัตโนมัติในแอป Android ที่เขียนด้วย Kotlin
  3. แอปจะนำเสนอการทำงานอัตโนมัติแก่ผู้ใช้โดยอิงตามข้อมูลเกี่ยวกับ อุปกรณ์ของผู้ใช้ ซึ่งรวมถึงลักษณะ คุณลักษณะ คำสั่ง และเหตุการณ์ที่รวบรวมโดยใช้ Discovery API หรือ Device API
    1. Discovery API ช่วยให้แอปสร้างการทำงานอัตโนมัติฉบับร่างที่ปรับแต่ง ให้เหมาะกับประเภทและลักษณะของอุปกรณ์ที่มีอยู่ในโครงสร้างของผู้ใช้ได้ โดยมีหรือ ไม่มีข้อมูลจากผู้ใช้ก็ได้
    2. Device API สามารถให้ข้อมูลส่วนใหญ่เหมือนกับ Discovery API แต่ไม่ได้ปรับให้เหมาะกับกรณีการใช้งานระบบอัตโนมัติ ดูรายละเอียดเพิ่มเติมได้ที่ เปรียบเทียบ Device API กับ Discovery API
  4. แอปจะสร้างการทำงานอัตโนมัติจริงที่เชื่อมโยงกับโครงสร้างที่เลือก
  5. ตอนนี้ระบบอัตโนมัติพร้อมใช้งานในโครงสร้างของผู้ใช้แล้ว และสามารถดำเนินการ หรือลบได้โดยใช้วิธีการของ Structure API

ผู้ใช้สร้างอินสแตนซ์ใหม่ของการทำงานอัตโนมัติได้ทุกเมื่อ โดยเลือกโครงสร้างอื่น หรืออาจเลือกชุดอุปกรณ์อื่น (ขึ้นอยู่กับตรรกะของแอป) ทุกครั้งที่ผู้ใช้ดำเนินการดังกล่าว แอปจะสร้างอินสแตนซ์ใหม่ของ การทำงานอัตโนมัติ

ในสถานการณ์พื้นฐานที่สุด คุณอาจแนะนำการทำงานอัตโนมัติที่กำหนดไว้ล่วงหน้า ซึ่งทำงานพื้นฐานพอสมควรแก่ผู้ใช้ หรือคุณอาจ นำเสนอโครงร่างของระบบอัตโนมัติที่ผู้ใช้ปรับแต่งให้ตรงกับ ความต้องการของตนเอง หรือคุณอาจเขียนเครื่องมือแก้ไขการทำงานอัตโนมัติแบบปลายเปิดที่อนุญาตให้ผู้ใช้ สร้างการทำงานอัตโนมัติที่ซับซ้อนโดยใช้บล็อกการสร้างทั้งหมดที่มีใน Automation API

คำแนะนำการทำงานอัตโนมัติ

Home API สามารถแนะนำการทำงานอัตโนมัติสำหรับ Structure โดยอิงตามปัจจัยต่างๆ เช่น ประเภทอุปกรณ์ที่มีอยู่ในพื้นที่

คำแนะนำการทำงานอัตโนมัติแสดงด้วยคลาส AutomationSuggestion

อินเทอร์เฟซ Structure ครอบคลุมอินเทอร์เฟซ HasSuggestions ซึ่งมีฟังก์ชัน suggestions() ซึ่งแสดงผลคอลเล็กชันของคำแนะนำในการทำงานอัตโนมัติ

เมธอด likeSuggestion() และ dislikeSuggestion() มีไว้เพื่อเชื่อมต่อกับ และ ตัวควบคุม UI ที่ผู้ใช้แตะเพื่อแสดงความคิดเห็นได้

วิธีที่ 3 clearSuggestionFeedback() ช่วยให้ผู้ใช้นำความคิดเห็นเกี่ยวกับการทำงานอัตโนมัติที่แนะนำออกได้

ความคิดเห็นของผู้ใช้มีผลต่อคำแนะนำในอนาคต

ขีดจำกัดทรัพยากร

การทำงานอัตโนมัติใน Home API มีข้อจำกัดดังต่อไปนี้

ตาราง: ขีดจํากัดของทรัพยากร Automation API
เมตริก ขีดจำกัด
จำนวนการทำงานอัตโนมัติสูงสุดต่อบ้าน 64
จำนวนโหนดสูงสุดต่อการทำงานอัตโนมัติ 128
จำนวนโหนดนิพจน์สูงสุดต่อการทำงานอัตโนมัติ 64
จำนวนอินสแตนซ์การทำงานอัตโนมัติสูงสุดต่อบ้าน 1024
จำนวนอินสแตนซ์การทำงานอัตโนมัติสูงสุดต่อผู้พัฒนาต่อบ้าน 64
จำนวนการดำเนินการสูงสุดต่อโครงสร้างต่อวัน 1024
จำนวนการดำเนินการสูงสุดต่อผู้พัฒนาต่อโครงสร้างต่อวัน 128
ถัดไป
ออกแบบการทำงานอัตโนมัติ