本頁面由 Cloud Translation API 翻譯而成。

適用於 Matter 的意圖式調校

雖然 Matter SDK 提供以 Task 為基礎的 API，可透過各種參數啟動 Matter 調試、觀察結果，以及視需要新增憑證，但在某些情況下，您可能只需要 QR code 做為進入點。例如，從一般相機應用程式提供捷徑，在觀景窗中看到 QR code 時啟動調試作業。

繼續操作前，請確認已符合所有必要條件。

Matter QR code

Matter QR code 採用 MT:Y3.13OTB00KA0648G00 的一般格式，其中 MT: 前置字串是常數，而後置字串則是使用字母 [A-Z0-9.-] 的 38 進位編碼字串。後置字串的長度必須至少為 19 個字元，但也可以更長。

如要判斷 QR code 是否代表 Matter QR code，可以使用 Java 中的以下規則運算式：

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

舉例來說，以下 QR code 代表 MT:Y3.13OTB00KA0648G00：

Matter QR code 範例

意圖格式

您可以使用這個 QR code 格式做為 URI，透過 ACTION_VIEW 傳送 Intent，並將 data 中指定的 URI 和目標套件設為 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
  }
}