ภาพรวมของ 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

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

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

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

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

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

  1. นักพัฒนาซอฟต์แวร์วางแผนการทำงานอัตโนมัติและกำหนดโดยใช้ 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