Ủy ban Matter dựa trên ý định

Mặc dù SDK Matter cung cấp một API dựa trên Task để bắt đầu chạy Matter với các tham số khác nhau, quan sát kết quả và thêm tuỳ ý thông tin xác thực, có những trường hợp mà điểm truy cập chỉ là một mã QR cần thiết. Ví dụ: từ một ứng dụng máy ảnh phổ biến muốn cung cấp lối tắt để bắt đầu vận hành khi phát hiện thấy mã QR trong kính ngắm.

Trước khi tiếp tục, hãy đảm bảo tất cả Đã đáp ứng các điều kiện tiên quyết.

Mã QR của Matter

Mã QR của Matter có hình thức chung là MT:Y3.13OTB00KA0648G00, trong đó tiền tố MT: là hằng số và hậu tố là một chuỗi được mã hoá theo cơ số 38 bằng cách sử dụng bảng chữ cái [A-Z0-9.-]. Hậu tố phải luôn có ít nhất 19 ký tự, nhưng cũng có thể dài hơn.

Để xác định xem mã QR có đại diện cho mã QR Matter hay không, có thể thực hiện bằng biểu thức chính quy sau đây trong Java:

fun isMatterQrCode(value: String): Boolean {
  return value.matches(Regex("""MT:[A-Z0-9.-]{19,}"""))
}

Ví dụ: mã QR sau đây đại diện cho MT:Y3.13OTB00KA0648G00:

Ví dụ về mã QR của Matter

Định dạng ý định

Bạn có thể dùng định dạng mã QR này làm URI để bắt đầu quy trình vận hành bằng cách gửi một Intent bằng ACTION_VIEW, URI được chỉ định trong data và gói mục tiêu được đặt thành Dịch vụ Google Play:

fun startCommissioning(context: Context, qrCodeString: String): Boolean {
  val intent =
    Intent(Intent.ACTION_VIEW)
      .setData(Uri.parse(qrCodeString))
      .setPackage("com.google.android.gms")

  try {
    context.startActivity(intent)
    return true
  } catch (ex: ActivityNotFoundException) {
    // Supporting Play Services version not available.
    return false
  }
}

Ứng dụng mẫu

Ứng dụng mẫu này hướng dẫn cách bắt đầu vận hành cho một thiết bị theo chuẩn Matter khi Bạn có thể nhìn thấy mã QR theo chuẩn Matter trong kính ngắm của máy ảnh.

Tải xuống ứng dụng mẫu Ủy quyền dựa trên ý định

Mã trong ứng dụng mẫu này tận dụng các thư viện Android sau:

Các tài liệu sau đây cũng hữu ích để hiểu mã được viết cho quy trình này ứng dụng mẫu:

Cách sử dụng

Khi ứng dụng khởi động, bản xem trước của máy ảnh sẽ xuất hiện trên màn hình. Khi mã QR đối với thiết bị theo chuẩn Matter được phát hiện, một hộp thoại sẽ xuất hiện để xác nhận xem quá trình vận hành cho thiết bị theo chuẩn Matter đó:

bản xem trước 1 của máy ảnh bản xem trước 2 của camera

Nếu yêu cầu vận hành được xác nhận thì "Bộ chọn ứng dụng" được hỗ trợ bởi Phát hành SDK dành cho thiết bị di động Google Home.

Ban đầu, Bộ chọn ứng dụng cho thấy một nhóm các ứng dụng mặc định cần chạy thử (ví dụ: ứng dụng Google Home như trong ảnh chụp màn hình đầu tiên). Nếu người dùng nhấn vào "Choose other app" (Chọn ứng dụng khác), thì các ứng dụng khác có hỗ trợ quy trình vận hành Google Home Mobile SDK sẽ hiển thị (xem ảnh chụp màn hình thứ hai).

Chọn một ứng dụng – GHA Chọn ứng dụng – Các ứng dụng khác

Sau đó, ứng dụng đã chọn sẽ chạy để tiến hành quá trình vận hành cho thiết bị.