Tổng quan về API Tự động hoá

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à. 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 tính năng Tự động hoá trong hệ sinh thái Google Home thông qua API Home. Các quy trình này sử dụng các khái niệm cơ bản giống như trong Quy trình GHAscript 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 được thông qua API Home, bao gồm:

  • Quyền truy cập vào tất cả các đặc điểm Mattersmart home tiêu chuẩn cho một thiết bị, như được trình bày trong API Home.
  • 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ữ chuyên biệt theo miền được thiết kế để xây dựng các 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 với API Thiết bị và Cấu trúc hoặc API Tự động hoá đều phải được đăng ký khi khởi chạy. Xem phần Khởi chạy trang chủ.

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

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

  1. Nhà phát triển lập kế hoạch tự động hoá và xác định kế hoạch đó bằng cách sử dụng DSL tự động hoá.
  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 hiển thị các tính nă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 API Khám phá hoặc API Thiết bị.
    1. Với API Khám phá, ứng dụng có thể tạo một bản nháp tự động hoá được tuỳ chỉnh cho các loại thiết bị và đặc điểm có trong cấu trúc của người dùng, có hoặc không có dữ liệu đầu vào của người dùng.
    2. API Thiết bị có thể cung cấp hầu hết thông tin giống như API Khám phá, nhưng API này 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 API thiết bị và API khám phá để biết thêm thông tin chi tiết.
  4. Ứng dụng sẽ tạo quy trình tự động hoá thực tế được khoá vào cấu trúc đã chọn.
  5. Tính năng tự động hoá hiện 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 API Cấu trúc.

Người dùng có thể tạo các thực thể 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 có thể là một nhóm thiết bị khác, tuỳ thuộc vào logic ứng dụng. Mỗi khi người dùng thực hiện việc này, ứng dụng sẽ tạo một thực thể mới của tính năng 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 nhiệm vụ tương đối cơ bản. Ngoài ra, bạn có thể trình bày một khung của quy trình tự động 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 giới hạn sau đây áp dụng cho các hoạt động tự động hoá trong API Nhà:

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