Tổng quan về Automation API trên Android

Tính năng tự động hoá là một cách để tự động hoá các công việc và chế độ cài đặt thiết bị trong nhà. Các quy trình tự động hoá đã có trong hệ sinh thái Google Home dưới dạng Quy trình trong Google Home app (GHA) và thông qua automation script editor trên Google Home for web.

Giờ đây, bạn có thể sử dụng các quy trình tự động hoá trong hệ sinh thái Google Home thông qua Home API cho Android. Các quy trình này sử dụng cùng những khái niệm cơ bản được dùng trong GHA Quy trình và script editor, nhưng có các tính năng và chức năng nâng cao chỉ có thể thực hiện thông qua Home API, bao gồm:

  • Quyền truy cập vào tất cả các đặc điểm Matter tiêu chuẩn và smart home cho một thiết bị, như được trình bày trong Home API.
  • Hỗ trợ các luồng thực thi tuần tự, song song và chọn lọc.

Các quy trình tự động hoá được viết bằng Automation DSL, một ngôn ngữ dành riêng cho miền được thiết kế để tạo quy trình tự động hoá trong Kotlin.

Mọi đặc điểm và loại mà bạn dự định sử dụng trong ứng dụng của mình bằng Device & Structure hoặc Automation API đều phải được đăng ký khi khởi tạo. Xem phần Khởi động trang chủ trên Android.

Hành trình của nhà phát triển

Automation API là một phần trong hành trình phát triển rộng lớn hơn. Bước này diễn ra sau khi bạn tích hợp API Cấu trúc và API Thiết bị để đảm bảo rằng người dùng có thể sử dụng tính năng tự động hoá khi muốn.

  1. Nhà phát triển lên kế hoạch tự động hoá và xác định kế hoạch đó bằng cách sử dụng Automation DSL.
  2. Nhà phát triển nhúng định nghĩa tự động hoá vào một ứng dụng Android Kotlin.
  3. Ứng dụng này cung cấp các hoạt động tự động hoá cho người dùng dựa trên thông tin về thiết bị của họ, bao gồm các đặc điểm, thuộc tính, lệnh và sự kiện, được thu thập bằng Discovery API hoặc Device API.
    1. Với Discovery API, ứng dụng có thể tạo một bản nháp tự động hoá được tuỳ chỉnh theo các loại và đặc điểm thiết bị có trong cấu trúc của người dùng, có hoặc không có thông tin đầu vào của người dùng.
    2. Device API có thể cung cấp hầu hết thông tin tương tự như Discovery API, nhưng không được tối ưu hoá cho các trường hợp sử dụng tự động hoá. Hãy xem phần So sánh Device API và Discovery API để biết thêm thông tin chi tiết.
  4. Ứng dụng này tạo ra quy trình tự động hoá thực tế dựa trên cấu trúc đã chọn.
  5. Giờ đây, quy trình tự động hoá có trong cấu trúc của người dùng và có thể được thực thi hoặc xoá bằng các phương thức Structure API.

Người dùng có thể tạo các phiên bản mới của quy trình tự động hoá bất cứ lúc nào, chọn một cấu trúc khác hoặc, tuỳ thuộc vào logic của ứng dụng, có thể là một nhóm thiết bị khác. Mỗi lần người dùng thực hiện thao tác này, ứng dụng sẽ tạo một phiên bản mới của quy trình tự động hoá.

Trong trường hợp cơ bản nhất, bạn có thể đề xuất cho người dùng một quy trình tự động hoá được xác định trước để thực hiện một tác vụ tương đối cơ bản. Ngoài ra, bạn có thể trình bày một cấu trúc cơ bản của quy trình tự động hoá mà người dùng tuỳ chỉnh để đáp ứng nhu cầu của họ. Hoặc bạn có thể viết một trình chỉnh sửa tự động hoá mở cho phép người dùng tạo các quy trình tự động hoá phức tạp bằng cách sử dụng tất cả các khối xây dựng có trong Automation API.

Giới hạn về tài nguyên

Các hạn mức sau đây áp dụng cho quy trình tự động hoá trong Home API:

Bảng: Giới hạn tài nguyên Automation API
Chỉ số Hạn mức
Số lượng thao tác tự động tối đa cho mỗi nhà 64
Số lượng nút tối đa cho mỗi quy trình tự động hoá 128
Số lượng tối đa các nút biểu thức cho mỗi quy trình tự động hoá 64
Số lượng phiên bản tự động hoá tối đa cho mỗi cấu trúc 1024
Số lượng phiên bản tự động hoá tối đa cho mỗi nhà phát triển trên mỗi cấu trúc 64
Số lần thực thi tối đa cho mỗi cấu trúc mỗi ngày 1024
Số lần thực thi tối đa trên mỗi nhà phát triển cho mỗi cấu trúc mỗi ngày 128