แม้ว่า 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
รูปแบบความตั้งใจ
รูปแบบคิวอาร์โค้ดนี้อาจใช้เป็น 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 หรือไม่
หากได้รับการยืนยันค่าคอมมิชชันแล้ว ระบบจะเปิดตัว "เครื่องมือเลือกแอป" ที่ SDK อุปกรณ์เคลื่อนที่ของ Google รองรับ
เครื่องมือเลือกแอปจะแสดงชุดแอปพลิเคชันค่าคอมมิชชันเริ่มต้น (เช่น แอป Google Home ดังที่แสดงในภาพหน้าจอแรก) หากแตะ "เลือกแอปอื่น" ค้างไว้ แอปพลิเคชันอื่นๆ ที่รองรับขั้นตอนการว่าจ้าง SDK อุปกรณ์เคลื่อนที่ของ Google Home จะปรากฏขึ้น (ดูภาพหน้าจอที่ 2)
จากนั้นแอปพลิเคชันที่เลือกจะเปิดขึ้นเพื่อดําเนินการว่าจ้างอุปกรณ์