Bạn có thể bắt đầu quy trình thiết lập trong ứng dụng bằng API Thiết lập theo 2 cách: trực tiếp trong ứng dụng hoặc thông qua bộ chọn ứng dụng trong quy trình Ghép nối nhanh. Phần này trình bày trải nghiệm người dùng (UX) cho từng cách.
Do ứng dụng khởi chạy
Trong trường hợp này, người dùng bắt đầu thiết lập trong ứng dụng của bạn, thường là từ một lời kêu gọi hành động (CTA) "Thêm thiết bị". Bạn nên cung cấp nút Thêm thiết bị như sau:
- Nơi người dùng thấy tất cả thiết bị của họ, chẳng hạn như trang Điều khiển
- Nơi người dùng có thể quản lý nhà, chẳng hạn như trang Cài đặt
- Trang Chủ của ứng dụng
Khi quá trình thiết lập hoàn tất, bạn nên đưa người dùng đến Trang chủ của ứng dụng hoặc đến vị trí trong ứng dụng cho thấy bộ điều khiển thiết bị mà người dùng vừa thiết lập hoặc cho thấy danh sách đầy đủ tất cả thiết bị, bao gồm cả thiết bị vừa thiết lập.
Trải nghiệm người dùng được minh hoạ trong Hình 2:
Người dùng ứng dụng nhấp vào Thêm thiết bị.
Người dùng quét mã QR hoặc nhập mã ghép nối.
Người dùng được nhắc đồng ý thêm thiết bị vào cấu trúc Google (tương ứng với "Đồng ý + Siêu dữ liệu" trong Hình 1) và chọn Tài khoản Google để sử dụng.
Nếu có nhiều Nhà, người dùng sẽ được nhắc chọn một Nhà. Nếu người dùng chưa thiết lập Nhà, thì một Nhà có tên là "Nhà" sẽ tự động được tạo.
API Thiết lập kết nối với thiết bị.
Người dùng được nhắc chọn phòng nơi thiết bị được đặt.
Người dùng được nhắc đổi tên thiết bị.
API Thiết lập tạo Matter thông tin xác thực, kiểm tra khả năng kết nối mạng, sau đó thực thi quy trình thiết lập, kết nối thiết bị với cấu trúc đã chọn.
Nếu đã được cấp quyền đối với cấu trúc và thiết bị của người dùng, thì thiết bị đó sẽ xuất hiện trong Nhà cùng với các thiết bị khác trong Nhà đó và có thể được điều khiển bằng ứng dụng.
Nếu chưa được cấp quyền đối với cấu trúc và thiết bị của người dùng, thì thiết bị đó sẽ chưa xuất hiện hoặc chưa điều khiển được trong ứng dụng. Bạn cần có quyền để truy cập và điều khiển thiết bị trong một ứng dụng.
Do Ghép nối nhanh khởi chạy
Bạn cũng có thể khởi chạy quy trình thiết lập bằng tính năng Ghép nối nhanh trong Android. Sau khi quét mã QR Mattercủa thiết bị, người dùng được nhắc chọn một ứng dụng để tiếp tục quy trình thiết lập. Việc chọn ứng dụng của bạn sẽ sử dụng API Thiết lập từ ứng dụng, như minh hoạ trong Hình 3.
Nếu người dùng chưa cài đặt ứng dụng trên thiết bị di động, họ sẽ được nhắc cài đặt trước khi tiếp tục. Trải nghiệm người dùng từ màn hình xin phép trở đi giống như trong Hình 2.
Người dùng được nhắc quét mã QR.
Người dùng quét mã QR Matter của thiết bị.
Người dùng được nhắc chọn một ứng dụng để tiếp tục quy trình thiết lập.
Nếu chưa cài đặt ứng dụng, người dùng sẽ được nhắc cài đặt.
Ứng dụng tải xuống từ Cửa hàng Google Play.
Ứng dụng được cài đặt.
Sau khi cài đặt thành công ứng dụng, người dùng được nhắc tiếp tục.
Người dùng được nhắc đồng ý thêm thiết bị vào cấu trúc Google (tương ứng với "Đồng ý + Siêu dữ liệu" trong Hình 1) và chọn Tài khoản Google để sử dụng.
Nếu có nhiều Nhà, người dùng sẽ được nhắc chọn một Nhà. Nếu người dùng chưa thiết lập Nhà, thì một Nhà có tên là "Nhà" sẽ tự động được tạo.
API Thiết lập kết nối với thiết bị.
Người dùng được nhắc chọn phòng nơi thiết bị được đặt.
Người dùng được nhắc đổi tên thiết bị.
API Thiết lập tạo Matter thông tin xác thực, kiểm tra khả năng kết nối mạng, sau đó thực thi quy trình thiết lập, kết nối thiết bị với cấu trúc đã chọn.
Nếu đã được cấp quyền đối với cấu trúc và thiết bị của người dùng thì thiết bị đó sẽ xuất hiện trong Nhà cùng với các thiết bị khác trong Nhà đó và có thể được điều khiển bằng ứng dụng.
Nếu chưa được cấp quyền đối với cấu trúc và thiết bị của người dùng thì thiết bị đó sẽ chưa xuất hiện hoặc chưa điều khiển được trong ứng dụng. Bạn cần có quyền để truy cập và điều khiển thiết bị trong một ứng dụng.
Bộ chọn ứng dụng
Ứng dụng của bạn xuất hiện theo 2 cách trong bộ chọn ứng dụng trong quá trình thiết lập:
- Trên màn hình Chọn một ứng dụng.
- Nếu người dùng chọn Chọn ứng dụng khác, thì ứng dụng đó sẽ xuất hiện trên màn hình Các ứng dụng đã cài đặt khác.
Ứng dụng được đề xuất
Bộ chọn ứng dụng hiển thị 2 ứng dụng được đề xuất.
- Ứng dụng đầu tiên luôn là Google Home app (GHA).
- Ứng dụng thứ hai là ứng dụng ưu tiên của nhà sản xuất thiết bị, nếu ứng dụng đó được xác định trong một
Google Home Developer Console dự án được liên kết với VID hoặc PID của
thiết bị. (Tuỳ chọn này không áp dụng cho nhà phát triển ứng dụng không
tạo Matter thiết bị.)
Có 2 trường hợp khi các ứng dụng xuất hiện trên màn hình Chọn một ứng dụng.
- Đã cài đặt - Google Play services kiểm tra xem ứng dụng có hỗ trợ
bộ lọc ý định
ACTION_COMMISSION_DEVICEhay không. Nếu bộ lọc ý định bị thiếu, người dùng sẽ được chuyển đến Cửa hàng Play để cập nhật ứng dụng. - Chưa cài đặt – Người dùng được chuyển đến Cửa hàng Play để cài đặt ứng dụng trước khi tiếp tục.