API Commissioning (Uỷ quyền) trên Android hỗ trợ tính năng quản trị nhiều người dùng (hoặc nhiều quản trị viên) cho Matter. Điều này có nghĩa là API Commissioning có thể đóng vai trò là người uỷ quyền Matter chính hoặc phụ và bạn có thể thêm người uỷ quyền của riêng mình:
Là người uỷ quyền Matter Matter chính:
- Ở chế độ này, cấu trúc Google được thêm vào trước tiên bằng cách sử dụng trải nghiệm người dùng của Google.
- Bạn có thể thêm người uỷ quyền tuỳ chỉnh.
- Người uỷ quyền của bạn được gọi sau khi cấu trúc Google được thêm vào thiết bị, sau đó, Matter cửa sổ uỷ quyền sẽ được mở lại.
- Nếu Google không thể hoàn tất quá trình uỷ quyền cho cấu trúc của riêng mình trước tiên vì bất kỳ lý do nào, thì dịch vụ uỷ quyền tuỳ chỉnh của bạn sẽ không chạy.
Là người uồi quyền Matter phụ:Matter
- Ở chế độ này, bạn có thể triển khai trải nghiệm người dùng uỷ quyền của riêng mình và tích hợp vào cấu trúc của riêng họ (hoặc vào các cấu trúc khác).
- Bạn có thể gọi API Commissioning của Google sau đó bằng một cửa sổ uỷ quyền đang mở để thêm cấu trúc Google. Ở chế độ này, Google đặc biệt khuyên bạn nên chủ động nhắc người dùng thêm cấu trúc của Google (bằng API Commissioning) sau khi quy trình uỷ quyền của bạn hoàn tất, khi người dùng cuối đã cấp cho bạn quyền sử dụng API Home.
Cách sử dụng API Commissioning làm người uỷ quyền Matter chính
Các bước này cho thấy quy trình uỷ quyền Matter đầy đủ tính năng của Matter mà Google ưu tiên:
Người dùng bắt đầu quy trình uỷ quyền trong ứng dụng. Ví dụ: người dùng nhấn vào một nút có nhãn Add Device (Thêm thiết bị).
Trải nghiệm người dùng của Google sẽ kiểm soát và hiển thị màn hình Scan Matter QR Code, cho phép người dùng quét mã QR để bắt đầu quy trình thiết lập.
Trên màn hình Connect this device to your Google account (Kết nối thiết bị này với Tài khoản Google của bạn), người dùng nhấn vào I agree (Tôi đồng ý) để thêm thiết bị vào hệ sinh thái Google. Nếu người dùng nhấn vào Cancel (Huỷ) trên màn hình này, thì tất cả quá trình uỷ quyền thiết bị sẽ kết thúc ngay lập tức.
Trên màn hình Choose a home (Chọn nhà), người dùng chọn nhà mà họ có thể điều khiển thiết bị. Nếu không có nhà nào, một nhà mới sẽ được tạo. Nếu không tìm thấy trung tâm thích hợp nào trong nhà hoặc nếu người dùng thiếu quyền, thì quá trình uỷ quyền sẽ kết thúc.
Màn hình Device connected (Thiết bị đã kết nối) sẽ xuất hiện tiếp theo và quá trình thiết lập Matter bắt đầu. Người dùng có thể chọn phòng và tên thiết bị trên màn hình này.
Màn hình Getting your device ready (Đang thiết lập thiết bị của bạn) xuất hiện khi thiết bị được tích hợp vào cấu trúc Matter.
Ứng dụng của bạn tiếp tục kiểm soát và người uỷ quyền tuỳ chỉnh (nếu đã đăng ký) sẽ chạy ngay.
Cách sử dụng API Commissioning làm người uỷ quyền Matter phụ
Các bước này cho thấy Matter quy trình uỷ quyền, trong đó quy trình uỷ quyền của bạn diễn ra trước quy trình uỷ quyền của Google:
Người dùng bắt đầu quy trình uỷ quyền trong ứng dụng của bạn. Ví dụ: người dùng nhấn vào Add Device (Thêm thiết bị).
Quy trình trải nghiệm người dùng uỷ quyền của bạn được chạy để thêm thiết bị vào cấu trúc của bạn.
Sau khi hoàn tất, bạn có thể chỉ định hành vi tiếp theo bằng cách dựa vào kiến thức của mình về người dùng. Ví dụ: nếu người dùng đã chọn sử dụng API Google Home (có khả năng cho thấy người dùng muốn uỷ quyền cho Google), bạn có thể kích hoạt quy trình uỷ quyền.
Quy trình của bạn gọi API Commissioning và cung cấp tải trọng chứa mật mã, bộ phân biệt và các thông tin có sẵn khác.
Quy trình uỷ quyền của Google sẽ thêm thiết bị vào cấu trúc Google.