ภาพรวมของ Automation API

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

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

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

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

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

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

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

1. นักพัฒนาแอปจะวางแผนการทำงานอัตโนมัติและกำหนดโดยใช้ Automation DSL
2. นักพัฒนาแอปฝังคําจํากัดความการทำงานอัตโนมัติในแอป Kotlin สำหรับ Android
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

ตาราง: ขีดจํากัดทรัพยากรของ Automation API

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