API uỷ quyền hỗ trợ nhiều chế độ quản trị (hoặc nhiều quản trị viên) cho Matter, tức là API uỷ quyền có thể đóng vai trò là uỷ viên Matter chính hoặc phụ và bạn có thể thêm uỷ viên của riêng mình:
Với tư cách là người uỷ quyền Matter chính:
- Trong chế độ này, Google Fabric được thêm trước bằng cách sử dụng Google UX.
- Bạn có thể thêm một người đặt hàng tuỳ chỉnh.
- Người uỷ quyền của bạn sẽ được gọi sau khi Google Fabric được thêm vào thiết bị, sau đó cửa sổ uỷ quyền Matter sẽ được mở lại.
- Nếu vì lý do nào đó mà Google không thể hoàn tất việc uỷ quyền cho fabric của riêng mình trước, thì dịch vụ uỷ quyền tuỳ chỉnh của bạn sẽ không chạy.
Với tư cách là uỷ viên Matter phụ:
- Ở 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à tham gia vào fabric của riêng họ (hoặc các fabric 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 Google Fabric. Ở chế độ này, Google đặc biệt khuyến nghị rằng khi người dùng cuối cấp cho bạn quyền sử dụng API Home, ứng dụng sẽ chủ động nhắc người dùng thêm Fabric của Google (bằng cách sử dụng API uỷ quyền) sau khi quy trình uỷ quyền của bạn hoàn tất.
Cách sử dụng API uỷ quyền làm uỷ quyền viên chính của Matter
Các bước sau đây cho thấy quy trình uỷ quyền đầy đủ tính năng 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 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 Quét mã QR Matter, 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 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 Tôi đồng ý để thêm thiết bị vào hệ sinh thái của Google. Nếu người dùng nhấn vào Cancel (Huỷ) trên màn hình này, tất cả quy trình uỷ quyền thiết bị sẽ kết thúc ngay lập tức.
Trên màn hình Chọn nhà, người dùng sẽ chọn nhà mà họ có thể điều khiển thiết bị. Nếu không có nhà nào, hệ thống sẽ tạo một nhà mới. Nếu không tìm thấy trung tâm phù hợp trong nhà hoặc nếu người dùng thiếu quyền, thì quy trình uỷ quyền sẽ kết thúc.
Tiếp theo, màn hình Device connected (Thiết bị đã kết nối) sẽ xuất hiện và quá trình thiết lập Matter sẽ bắt đầu. Người dùng có thể chọn tê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 đưa vào mạng Matter.
Ứng dụng của bạn sẽ tiếp tục kiểm soát và trình 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 uỷ quyền viên phụ trách Matter
Các bước này cho thấy quy trình uỷ quyền Matter, 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 Thêm thiết bị.
Quá trình uỷ quyền trải nghiệm người dùng sẽ chạy để thêm một thiết bị vào Fabric.
Sau khi hoàn tất, bạn có thể chỉ định hành vi tiếp theo dựa trên kiến thức của bạn về người dùng. Ví dụ: nếu người dùng đã chọn sử dụng API Google Home, thì điều này có thể cho biết 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 gọi API uỷ quyền và cung cấp tải trọng, trong đó chứa mã xác thực, giá trị 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 Google Fabric.