עמלה לפי כוונת רכישה בתקן Matter

ממשק Matter SDK מספק API מבוסס-Task להתחלת השימוש בתקן Matter עם פרמטרים משתנים, תוך בחינת התוצאה, ובאופן אופציונלי גם הוספה של פרטי כניסה. עם זאת, במצבים מסוימים יש צורך בנקודת כניסה של קוד QR בלבד. לדוגמה, מאפליקציית מצלמה כללית שרוצה לספק קיצור דרך כדי להתחיל לבצע הזמנה כשמופיע קוד QR בעינית.

לפני שממשיכים, חשוב לוודא שכל הדרישות המוקדמות מתקיימות.

קודי QR של Matter

קודי QR בתקן Matter הם MT:Y3.13OTB00KA0648G00, והקידומת MT: היא קבוע. הסיומת היא מקודד בבסיס 38 המבוסס על אלפבית [A-Z0-9.-]. הסיומת חייבת תמיד לכלול 19 תווים לפחות, אבל גם יכולה להיות ארוכה יותר.

כדי לקבוע אם קוד QR מייצג קוד QR של Matter, תוכלו להשתמש ב-regex הבא:

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

לדוגמה, קוד ה-QR הבא מייצג את MT:Y3.13OTB00KA0648G00:

דוגמה לקוד QR של Matter

פורמט Intent

אפשר להשתמש בפורמט של קוד QR כ-URI כדי להתחיל את תהליך ההזמנה על ידי שליחת Intent עם ACTION_VIEW, ה-URI שצוין ב-data וחבילת היעד שהוגדרה ל-Google Play Services:

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 כשקוד ה-QR שתואם לתקן Matter נראה בעינית המצלמה.

איך מורידים את האפליקציה לדוגמה שמבוססת על עמלות?

הקוד באפליקציה לדוגמה הזו משתמש בספריות הבאות של Android:

המסמכים הבאים שימושיים גם להבנת הקוד שנכתב עבור האפליקציה לדוגמה:

Usage

כשהאפליקציה מופעלת, התצוגה המקדימה של המצלמה מוצגת במסך. כשמזוהה קוד QR למכשיר Matter, מוצגת תיבת דו-שיח שבה אתם צריכים לבדוק אם צריך לבצע עמלות על אותו מכשיר:

תצוגה מקדימה של המצלמה 1 תצוגה מקדימה של המצלמה 2

אם האפליקציה תאושר, יופעל ה-App Picker שנתמך על ידי Google Home Mobile SDK.

בוחר האפליקציות מציג תחילה קבוצה של אפליקציות ברירת מחדל להזמנה (לדוגמה, אפליקציית Google Home כפי שמוצגת בצילום המסך הראשון). אם הקשה על "בחירת אפליקציה אחרת" תציג אפליקציות אחרות שתומכות בתהליך בחירת ה-SDK של Google Home לנייד (ראו את צילום המסך השני).

בחירת אפליקציה – GHA בחירת אפליקציה – אפליקציות אחרות

לאחר מכן, האפליקציה שנבחרה מופעלת לביצוע הזמנת המכשיר.