Hỗ trợ đặc điểm Automation API trên Android

Automation API cho Android hỗ trợ hầu hết các đặc điểm, nhưng khả năng hỗ trợ một số thuộc tính, sự kiện và lệnh trong một đặc điểm có thể bị hạn chế.

Nói chung:

• Mọi đặc điểm và loại mà bạn dự định sử dụng trong ứng dụng bằng Automation API đều phải được đăng ký khi khởi chạy. Xem phần Tạo một thực thể Home.
• Bạn có thể sử dụng bất kỳ thuộc tính nào trong điều kiện khởi động hoặc điều kiện.
• Cloud-to-cloud thiết bị không báo cáo trạng thái không thể dùng làm điều kiện kích hoạt trong quy trình tự động hoá, dù được tạo theo cách thủ công hay thông qua tính năng khám phá.

• Ngay cả khi một thiết bị hỗ trợ các đặc điểm được liệt kê ở đây, thiết bị đó vẫn có thể bị chặn sử dụng làm điều kiện khởi động hoặc hành động trong Automation API do ngưỡng chất lượng của Báo cáo trạng thái:

  • Những thiết bị có tỷ lệ thành công của Report State thấp hơn 90% sẽ bị chặn sử dụng làm điều kiện khởi động.
  • Những thiết bị có tỷ lệ thực thi lệnh thành công thấp hơn 95% sẽ bị chặn sử dụng làm hành động.

  Hãy tham khảo danh sách mẫu thiết bị này và các điều kiện khởi động cũng như hành động cụ thể mà các mẫu thiết bị này hỗ trợ cho Automations API.

• Bạn chỉ có thể sử dụng lệnh làm hành động.

• Một số đặc điểm, chẳng hạn như AssistantBroadcast và Notification, chỉ có thể dùng trong Automation API.

• Lệnh okGoogle là lệnh ở cấp cấu trúc và có thể dùng để tự động hoá mọi thiết bị trong cấu trúc. Tuy nhiên, ứng dụng Home API có thể không có quyền truy cập vào mọi thiết bị. Hãy xem phần Quyền OkGoogle để biết cách thực thi quyền trong nhiều trường hợp.

• Một số đặc điểm có điều kiện tiên quyết:

  • Để sử dụng các điều kiện khởi động dựa trên thời gian như Time.ScheduledTimeEvent, Time.RecurringClockTimeScheduledEvent, hoặc Time.RecurringSolarTimeScheduledEvent, nhà nơi quy trình tự động hoá chạy phải có địa chỉ đường phố để xác định múi giờ địa phương và tính toán theo mặt trời. Bạn có thể cung cấp địa chỉ trong quá trình tạo cấu trúc hoặc đặt địa chỉ trong Google Home app (GHA). Thay đổi địa chỉ nhà riêng trên Google giải thích cách người dùng có thể nhập hoặc cập nhật địa chỉ nhà trong GHA. Nếu địa chỉ chưa được thiết lập, createAutomation() sẽ lưu và trả về một Automation trong đó isValid == false, kèm theo một vấn đề xác thực UnsupportedEntityEvent chứa MissingStructureAddressSetup.
  • Để nhận được thông báo từ Notification.sendNotifications, thành viên trong hộ gia đình phải cài đặt GHA và bật thông báo. Thông báo được gửi đến thành viên thông qua GHA và không thể gửi trực tiếp đến các ứng dụng bên thứ ba.
  • Để sử dụng các đặc điểm AreaPresenceState hoặc AreaAttendanceState, người dùng phải thiết lập tính năng phát hiện sự hiện diện trong GHA.
  • Để sử dụng đặc điểm ObjectDetection, người dùng phải có một gói thuê bao Google Home Premium đang hoạt động.

Bạn cũng có thể sử dụng phiên bản đơn giản của một số đặc điểm trong quy trình tự động hoá. Để biết thêm thông tin, hãy xem bài viết Đặc điểm đơn giản hoá trên Android.