הרשאה לחשבון ב-Android

לפני שתמשיכו בתהליך אישור החשבון, ודאו שיש לכם:

  1. Google Home app (GHA) מותקנת במכשיר הנייד עם Android.
  2. לפחות אחד מסוגי המכשירים הנתמכים הבאים לאפליקציה לדוגמה בבית:
    • תאורה עם טמפרטורת צבע (הפעלה וכיבוי, בהירות)
    • חיישן מגע (מצב בוליאני)
    • תאורה ניתנת לעמעום (הפעלה וכיבוי, בהירות)
    • מנעול דלת
    • תאורה בצבעים מורחבים (הפעלה וכיבוי, בהירות)
    • Generic Switch
    • נתב גבולות של Google
    • מצלמת Google
    • Google Doorbell
    • חיישן נוכחות (זיהוי נוכחות)
    • הפעלה/כיבוי של תאורה (הפעלה וכיבוי, בהירות)
    • מתג הפעלה/כיבוי של התאורה
    • יחידת תקע להפעלה/כיבוי (הפעלה וכיבוי)
    • חיישן הפעלה/כיבוי
  3. שני מכשירים לבדיקת האוטומציה לדוגמה.

כדי להשתמש במכשירים דרך ממשקי Home API, צריך שתהיה אפשרות לשלוט בהם דרך GHA.

הפעלת האפליקציה לדוגמה ל-Android

לפני שמאשרים חשבון, צריך לוודא שהאפליקציה לדוגמה מוגדרת עם היקף ההרשאות המתאים של OAuth לפרויקט. כברירת מחדל, קוד המקור של האפליקציה לדוגמה משתמש בהיקף https://www.googleapis.com/auth/home.platform.v2. הרבה תכונות באפליקציה לדוגמה מוגבלות על ידי ההיקף home.platform.v2, וצריך אישור מהשותף כדי לגשת אליהן. כדי לאשר את השימוש באפליקציה לדוגמה עם היקף https://www.googleapis.com/auth/home.platform.selected.devices סטנדרטי, צריך להחליף באופן ידני את homePlatformScope ל-HOME_PLATFORM_SCOPE_VERSION_1 ב-HomeModule.kt, כמו שמתואר במאמר יצירת האפליקציה.

מפעילים את האפליקציה לדוגמה ל-Android. בפעם הראשונה שמפעילים אותה, תתבקשו לאשר גישה לבית בחשבון Google שלכם. כך אתם נותנים לאפליקציה לדוגמה הרשאה לגשת ולשלוט במבנים ובמכשירים בבית הזה.

אם אין לכם מבנה, המשתמש יכול ליצור מבנה במהלך תהליך ההרשאה בלי להשתמש ב-GHA.

התנהגות ברירת המחדל של ההרשאות באפליקציה תהיה שונה בהתאם לשאלה אם האפליקציה רשומה ב-Google Home Developer Console או לא.

אם אפליקציה לא רשומה ב-Developer Console, היא תהיה במצב לא מאומת. מומלץ להשתמש בזה כדי לבדוק את השימוש ב-Home APIs:

  • רק משתמשים שנרשמו כמשתמשי בדיקה במסוף OAuth יכולים לתת הרשאות לאפליקציה. אפשר להגדיר עד 100 משתמשי בדיקה לאפליקציה לא מאומתת.

  • לאפליקציה לא מאומתת תהיה גישה למכשירים מכל הסוגים שנתמכים על ידי OAuth עבור ממשקי ה-API של Home (רשימת סוגי המכשירים מופיעה בDeveloper Console). כל המכשירים במבנה יקבלו גישה.

אם אפליקציה רשומה בDeveloper Console ואושרה לה גישה לסוג מכשיר אחד או יותר, ואימות המותג הושלם עבור OAuth, האפליקציה תהיה במצב מאומת. הסטטוס הזה נדרש כדי להשיק אפליקציה בסביבת הייצור:

  • המגבלות על משתמשי הבדיקה לא חלות יותר. כל משתמש יכול להעניק הרשאה לאפליקציה.
  • המשתמש יכול לתת הרשאה רק לסוגי המכשירים שאושרו ב-Developer Console.

לוחצים על מתן גישה לבית שנבחר:

  • אם יש בתים שמקושרים לחשבון, בוחרים את הבית שרוצים לתת לו הרשאה. אם לא נמצאו מכשירים בבית שנבחר, אתם יכולים:
    1. מקישים על מתן הרשאת גישה לבית אחר כדי לבחור בית אחר.
    2. מגדירים מכשיר לבחירתכם בבית הזה באמצעות Google Home app (GHA). חשוב לזכור, רק לסוגי המכשירים הבאים יש תמיכה בשליטה באפליקציה לדוגמה הזו:
      • אור עם טמפרטורת צבע (הפעלה והשבתה, בהירות)
      • חיישן מגע (מצב בוליאני)
      • תאורה ניתנת לעמעום (הפעלה וכיבוי, בהירות)
      • מנעול דלת
      • תאורה בצבעים מורחבים (הפעלה וכיבוי, בהירות)
      • Generic Switch
      • נתב גבולות של Google
      • מצלמת Google
      • Google Doorbell
      • חיישן נוכחות (זיהוי נוכחות)
      • הפעלה/כיבוי של תאורה (הפעלה וכיבוי, בהירות)
      • מתג הפעלה/כיבוי של התאורה
      • יחידת תקע להפעלה/כיבוי (הפעלה וכיבוי)
      • חיישן הפעלה/כיבוי
  • אם אין בתים שמקושרים לחשבון, יופיע מסך עם ההודעה אין מבנים בחשבון שנבחר.
    1. מחליקים אחורה כדי לחזור לתצוגה הראשית של האפליקציה לדוגמה.
    2. כדי להגדיר בית, משתמשים ב-GHA. אחר כך נסו לתת שוב הרשאה לאפליקציה לדוגמה.

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

בחירת מבנה להרצת אפליקציית הדוגמה.
איור 1: בחירת מבנה
הבית הווירטואלי שנבחר, עם המכשירים הזמינים.
איור 2: מבנה ומכשירים
הגדרות השליטה במכשיר.
איור 3: אמצעי בקרה למכשירים
המבנה שנבחר, שבו מוצגות האפשרויות לאוטומציה.
איור 4: מבנה ואוטומציות

אחרי שתאשרו את הגישה לבית שכולל מכשירים, תועברו לתצוגת המכשירים. אתם יכולים לשלוט במכשירים ולראות את השינויים במצב שלהם דרך האפליקציה לדוגמה.