ภาพรวมของ 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 ทั้งหมด smart home สำหรับอุปกรณ์ตามที่แสดงใน Home API
  • รองรับโฟลว์การดำเนินการแบบลำดับ แบบขนาน และแบบเลือก

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

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

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

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

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

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

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