Trước khi tiến hành uỷ quyền tài khoản, hãy đảm bảo rằng bạn có:
- Google Home app (GHA) được cài đặt trên thiết bị di động Android.
- Ít nhất một trong các loại thiết bị được hỗ trợ sau đây cho Ứng dụng mẫu trong nhà:
- Đèn có nhiệt độ màu (bật và tắt, độ sáng)
- Cảm biến tiếp xúc (trạng thái boolean)
- Đèn có thể điều chỉnh độ sáng (bật và tắt, độ sáng)
- Khoá cửa
- Đèn có màu mở rộng (bật và tắt, độ sáng)
- Công tắc chung
- Bộ định tuyến biên của Google
- Google Máy ảnh
- Chuông cửa Google
- Cảm biến phát hiện người trong nhà (cảm biến phát hiện người trong nhà)
- Đèn bật/tắt (bật và tắt, độ sáng)
- Công tắc đèn bật/tắt
- Thiết bị bật/tắt (bật và tắt)
- Cảm biến bật/tắt
- Hai thiết bị để kiểm thử quy trình tự động hoá mẫu.
Trước khi sử dụng thiết bị thông qua API Nhà thông minh, bạn phải có thể điều khiển các thiết bị đó từ GHA.
Chạy Ứng dụng mẫu Android
Trước khi uỷ quyền cho một tài khoản, hãy xác minh rằng Ứng dụng mẫu được định cấu hình với phạm vi OAuth thích hợp cho dự án của bạn. Theo mặc định, mã nguồn Ứng dụng mẫu sử dụng phạm vi https://www.googleapis.com/auth/home.platform.v2. Nhiều tính năng trong Ứng dụng mẫu được kiểm soát bằng phạm vi home.platform.v2 và yêu cầu đối tác phê duyệt để truy cập. Để uỷ quyền và sử dụng Ứng dụng mẫu với phạm vi tiêu chuẩn
https://www.googleapis.com/auth/home.platform.selected.devices, hãy chuyển homePlatformScope sang HOME_PLATFORM_SCOPE_VERSION_1 theo cách thủ công trong HomeModule.kt
như mô tả trong phần Tạo ứng dụng.
Chạy Ứng dụng mẫu Android. Trong lần đầu tiên chạy ứng dụng này, bạn sẽ được yêu cầu cho phép truy cập vào một nhà trên Tài khoản Google của mình. Việc này cấp cho Ứng dụng mẫu quyền cho ứng dụng truy cập và điều khiển các cấu trúc và thiết bị trong nhà đó.
Nếu bạn không có cấu trúc, người dùng có thể tạo một cấu trúc trong quy trình cấp quyền mà không cần sử dụng GHA.
Hành vi cấp quyền mặc định của ứng dụng sẽ khác nhau tuỳ thuộc vào việc ứng dụng có được đăng ký trên Google Home Developer Console hay không.
Nếu một ứng dụng không được đăng ký trong Developer Console, thì ứng dụng đó sẽ ở trạng thái chưa xác minh. Bạn nên sử dụng trạng thái này để kiểm thử việc sử dụng API Nhà thông minh:
Chỉ những người dùng được đăng ký làm người dùng thử nghiệm trong bảng điều khiển OAuth mới có thể cấp quyền cho ứng dụng. Có giới hạn 100 người dùng thử nghiệm cho một ứng dụng chưa xác minh.
Một ứng dụng chưa xác minh sẽ có quyền truy cập vào các thiết bị thuộc mọi loại thiết bị được OAuth hỗ trợ cho API Nhà thông minh (danh sách các loại thiết bị trong Developer Console). Tất cả thiết bị trong một cấu trúc sẽ được cấp quyền.
Nếu một ứng dụng được đăng ký trong Developer Console và đã được phê duyệt quyền truy cập vào một hoặc nhiều loại thiết bị, đồng thời quá trình xác minh thương hiệu đã hoàn tất cho OAuth, thì ứng dụng đó sẽ ở trạng thái đã xác minh. Bạn phải ở trạng thái này để chạy một ứng dụng vào môi trường thực tế:
- Giới hạn người dùng thử nghiệm không còn áp dụng. Bất kỳ người dùng nào cũng có thể cấp quyền cho ứng dụng.
- Người dùng chỉ có thể cấp quyền cho các loại thiết bị đã được phê duyệt trong Developer Console.
Nhấn vào Cho phép truy cập vào một nhà đã chọn:
- Nếu có bất kỳ nhà nào được kết nối với tài khoản của bạn, hãy chọn một nhà để cấp quyền. Nếu không tìm thấy thiết bị nào trong nhà đã chọn, bạn có thể:
- Nhấn vào Cho phép truy cập vào một nhà khác để chọn một nhà khác.
- Thiết lập một thiết bị mà bạn chọn
trong nhà đó bằng Google Home app (GHA). Xin lưu ý rằng chỉ những loại thiết bị này mới được hỗ trợ điều khiển trong Ứng dụng mẫu này:
- Đèn có nhiệt độ màu (bật và tắt, độ sáng)
- Cảm biến tiếp xúc (trạng thái boolean)
- Đèn có thể điều chỉnh độ sáng (bật và tắt, độ sáng)
- Khoá cửa
- Đèn có màu mở rộng (bật và tắt, độ sáng)
- Công tắc chung
- Bộ định tuyến biên của Google
- Google Máy ảnh
- Chuông cửa Google
- Cảm biến phát hiện người trong nhà (cảm biến phát hiện người trong nhà)
- Đèn bật/tắt (bật và tắt, độ sáng)
- Công tắc đèn bật/tắt
- Thiết bị bật/tắt (bật và tắt)
- Cảm biến bật/tắt
- Nếu không có nhà nào được kết nối với tài khoản của bạn, bạn sẽ thấy một màn hình có thông báo Không có cấu trúc nào cho tài khoản đã chọn.
- Vuốt để quay lại chế độ xem ứng dụng mẫu chính.
- Để thiết lập một nhà, hãy sử dụng GHA. Sau đó, hãy thử cấp quyền cho Ứng dụng mẫu một lần nữa.
Bạn có thể xem lại quy trình cấp quyền bất cứ lúc nào bằng cách chọn biểu tượng hồ sơ ở phía trên bên phải của bất kỳ màn hình Ứng dụng mẫu nào.
Sau khi cấp quyền thành công cho một nhà có thiết bị, bạn sẽ được chuyển đến chế độ xem thiết bị. Bạn có thể điều khiển các thiết bị và quan sát các thay đổi về trạng thái của chúng thông qua Ứng dụng mẫu.