Bạn có thể bắt đầu quy trình thiết lập trong ứng dụng của mình 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 về trải nghiệm người dùng (UX) cho từng cách.
Do ứng dụng bắt đầu
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 giới thiệu nút Thêm thiết bị như sau:
- Nơi người dùng nhìn 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ính 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 hiển thị bộ điều khiển thiết bị mà họ vừa thiết lập hoặc hiển thị 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 họ chưa thiết lập Nhà, thì một Nhà có tên "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 thông tin xác thựcMatter, 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ấp quyền cho 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ấp quyền cho cấu trúc và thiết bị của người dùng, thì thiết bị sẽ chưa hiển thị hoặc đ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 bắt đầu
Bạn cũng có thể bắt đầu 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 sẽ đượ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 ứng dụng thành công, người dùng sẽ đượ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 họ chưa thiết lập Nhà, thì một Nhà có tên "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ấp quyền cho cấu trúc và thiết bị của người dùng đã được cấp, 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ấp quyền cho cấu trúc và thiết bị của người dùng thì thiết bị sẽ chưa hiển thị hoặc đ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
Có 2 cách để ứng dụng của bạn xuất hiện trong bộ chọn ứng dụng trong quy 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ị. (Lựa chọn này không áp dụng cho các 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.