API Commissioning (Uỷ quyền) trên Android hỗ trợ nhiều quản trị viên (hoặc nhiều quản trị) cho Matter. Điều này có nghĩa là API Commissioning có thể đóng vai trò là người uỷ quyền chính hoặc phụ cho Matter và bạn có thể thêm người uỷ quyền của riêng mình:
Là người uỷ quyền chính cho Matter commissioner:
- Ở chế độ này, cấu trúc Google được thêm 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ẽ mở lại.
- Nếu Google không thể hoàn tất việc 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ỷ quyền phụ cho Matter commissioner:
- Ở 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 uỷ quyền 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 nhắc người dùng thêm cấu trúc của Google (bằng API uỷ quyền) 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 uỷ quyền làm người uỷ quyền chính cho Matter
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 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 quá 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) sẽ 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 uỷ quyền làm người uỷ quyền phụ cho Matter
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 sẽ 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 (điều này có thể cho thấy rằng 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 sẽ gọi API uỷ quyền và cung cấp tải trọng chứa mật mã, bộ phân biệt và các thông tin khác có sẵn.
Quy trình uỷ quyền của Google sẽ thêm thiết bị vào cấu trúc Google.