การจัดเตรียมแบบอิงตามความตั้งใจสำหรับกรณี

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

ก่อนดำเนินการต่อ โปรดตรวจสอบว่า เป็นไปตามข้อกำหนดเบื้องต้น

คิวอาร์โค้ดของ 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

รูปแบบ Intent

รูปแบบคิวอาร์โค้ดนี้สามารถใช้เป็น 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 เมื่อ คิวอาร์โค้ดที่เป็นไปตามข้อกำหนดของ Matter จะแสดงในช่องมองภาพของกล้อง

ดาวน์โหลด แอปตัวอย่างการค่าคอมมิชชันที่อิงตาม Intent

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

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

การใช้งาน

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

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

หากการสมัครใช้บริการได้รับการยืนยัน "เครื่องมือเลือกแอป" ที่รองรับโดย เปิดตัว Google Home Mobile SDK

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

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

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