การอิงตามความตั้งใจ

แม้ว่า SDK ของ Matter จะมี API ที่ใช้ Task เพื่อเริ่มการค่าคอมมิชชัน Matter ด้วยพารามิเตอร์ที่ต่างกัน การสังเกตผลลัพธ์ และสามารถเลือกเพิ่มข้อมูลเข้าสู่ระบบ แต่ก็มีบางกรณีที่จําเป็นต้องใช้จุดเข้าถึงคิวอาร์โค้ดเท่านั้น ตัวอย่างเช่น จากแอปพลิเคชันกล้องทั่วไปที่ต้องการมอบทางลัดเพื่อเริ่มค่าคอมมิชชันเมื่อมองเห็นคิวอาร์โค้ดในช่องมองภาพ

ก่อนดําเนินการต่อ โปรดตรวจสอบว่าได้ดําเนินการตามข้อกําหนดเบื้องต้นทั้งหมดแล้ว

คิวอาร์โค้ด

คิวอาร์โค้ดของ Matter ใช้รูปแบบทั่วไปของ MT:Y3.13OTB00KA0648G00 โดยที่คํานําหน้า MT: เป็นค่าคงที่และคําต่อท้ายคือสตริงที่เข้ารหัสพื้นฐาน 38 ซึ่งใช้ตัวอักษร [A-Z0-9.-] คําต่อท้ายต้องยาวอย่างน้อย 19 อักขระ แต่อาจนานกว่านั้นด้วย

การตรวจสอบว่าคิวอาร์โค้ดแสดงถึงคิวอาร์โค้ดของ Matter หรือไม่ด้วยนิพจน์ทั่วไปต่อไปนี้ใน Java

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

เช่น คิวอาร์โค้ดต่อไปนี้แสดงถึง MT:Y3.13OTB00KA0648G00

ตัวอย่างคิวอาร์โค้ดสําหรับ Matter

รูปแบบความตั้งใจ

รูปแบบคิวอาร์โค้ดนี้อาจใช้เป็น URI เพื่อเริ่มขั้นตอนค่าคอมมิชชันโดยการส่ง Intent ที่มี ACTION_VIEW, URI ที่ระบุใน data และแพ็กเกจเป้าหมายที่ตั้งไว้สําหรับบริการ 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
  }
}

แอปตัวอย่าง

แอปตัวอย่างนี้แสดงวิธีเริ่มอุปกรณ์ Matter เมื่อเห็นคิวอาร์โค้ดที่เป็นไปตามข้อกําหนดในช่องมองภาพของกล้อง

ดาวน์โหลดแอปตัวอย่างค่าคอมมิชชันตามความตั้งใจ

โค้ดในแอปตัวอย่างนี้ใช้ประโยชน์จากไลบรารี Android ต่อไปนี้

เอกสารต่อไปนี้มีประโยชน์ในการทําความเข้าใจโค้ดที่เขียนสําหรับแอปตัวอย่างนี้

การใช้งาน

เมื่อแอปเริ่มทํางาน การแสดงตัวอย่างของกล้องจะแสดงบนหน้าจอ เมื่อตรวจพบคิวอาร์โค้ดสําหรับอุปกรณ์ Matter กล่องโต้ตอบจะปรากฏขึ้นเพื่อยืนยันว่าควรใช้ค่าคอมมิชชันสําหรับอุปกรณ์ Matter หรือไม่

แสดงตัวอย่างกล้อง 1 แสดงตัวอย่างกล้อง 2

หากได้รับการยืนยันค่าคอมมิชชันแล้ว ระบบจะเปิดตัว "เครื่องมือเลือกแอป" ที่ SDK อุปกรณ์เคลื่อนที่ของ Google รองรับ

เครื่องมือเลือกแอปจะแสดงชุดแอปพลิเคชันค่าคอมมิชชันเริ่มต้น (เช่น แอป Google Home ดังที่แสดงในภาพหน้าจอแรก) หากแตะ "เลือกแอปอื่น" ค้างไว้ แอปพลิเคชันอื่นๆ ที่รองรับขั้นตอนการว่าจ้าง SDK อุปกรณ์เคลื่อนที่ของ Google Home จะปรากฏขึ้น (ดูภาพหน้าจอที่ 2)

เลือกแอป - GHA เลือกแอป - แอปอื่นๆ

จากนั้นแอปพลิเคชันที่เลือกจะเปิดขึ้นเพื่อดําเนินการว่าจ้างอุปกรณ์