שאלות נפוצות על בית חכם

כללי

ש: איפה ובאיזו שפה כדאי להטמיע את תשתית המעבר מענן לענן?

תשובה: כל עוד הפלטפורמה תומכת ב-SSL (TLS) וב-OAuth 2.0, אתם יכולים להטמיע את התשתית בכל פלטפורמה ובכל שפה שתבחרו. מומלץ לפרוס את המערכת כמה שיותר קרוב לשאר התשתית, כדי לשפר את האמינות ולקצר את זמן האחזור של הביצוע במכשירי משתמשים בפועל.

ש:האם מזהי המכשירים צריכים להיות ייחודיים?

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

שאלה: האם שמות המכשירים צריכים להיות ייחודיים?

תשובה: השמות לא חייבים להיות ייחודיים, אבל עם הזמן יכול להיות שנמליץ לאנשים לשפר שמות לא טובים אחרי ההגדרה, כדי לשפר את חוויית המשתמש.

הנה מדריך קצר למתן שמות:

  • השמות צריכים להיות כאלה שאנשים יכולים להגיד.
  • אנחנו מזהים קבוצות משנה של מחרוזות, כך שאם יש לכם 'acme color light' אנחנו גם נענה ל-'acme light'.
  • מומלץ להשתמש בשם תיאורי למוצר וגם בשם אחד או יותר שהוגדרו על ידי המשתמש.
  • המשתמשים לא צריכים לתת שמות לחדרים של האורות, כי יש לנו חדרים בשביל זה. השמות צריכים להיות ייחודיים לכל חדר, אבל תמיד אפשר להשתמש בלשון רבים כדי לשלוט בכל האורות (לדוגמה, שתי הנורות במנורות הקיר במשרד הן 'אור צפוני' ו'אור מזרחי', אבל אפשר לשלוט בהן באמצעות הפקודה 'אורות').

ש: באיזו תדירות מתעדכן סטטוס המכשיר?

‫A: המצב הזמני מאוחזר בפעולות QUERY או EXECUTE, שהן פעולות שהמשתמש יזם. אם המשתמש שואל 'האור דולק?' או רוצה להגביר את עוצמת האור, נצטרך לבצע שאילתה כדי לברר את המצב הנוכחי.

שאלה: האם אפשר לעדכן את תרשים הבית ישירות עם המצב הנוכחי של מכשיר?

תשובה: כן, אפשר להשתמש בקריאה ל-API ‏Report State.

קישור חשבונות ו-OAuth

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

שאלה: ב-OAuth, אנחנו מבטלים את תוקף אסימוני הגישה כל 15.213 שעות. זה בסדר?

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

כוונות

ש: מתי מתבצע הסנכרון?

ת: הסנכרון מתבצע מיד אחרי השלמת OAuth, ואחרי שמתבצעת קריאה של Request Sync.

ש: למה SYNC לא פועל?

תשובה: יש כמה סיבות נפוצות לכך שהפעולה נכשלת.

  • אתם שולחים סוגי מכשירים שגויים.

    • לדוגמה, אנחנו מצפים לקבל action.devices.types.LIGHT, אבל אתם שולחים action.devices.types.Light.

  • אתם שולחים סוגי מכשירים שלא נתמכים.

    • לדוגמה, אם תשלחו action.devices.types.FLASHLIGHT, לא נוכל לתמוך בבקשה.

  • אתם שולחים שדות לא תקינים או לא נתמכים.

    • לדוגמה, יש לכם שדה שלא מופיע במפרט שלנו.

  • יש בעיה אחרת בעיצוב של תגובת ה-SYNC.

    • כדאי לבדוק את הסוגריים!

  • נתקלת בבעיה בקישור החשבון.

    • צריך לוודא שמתקבל טוקן גישה תקין בכותרת Auth של בקשת הסנכרון.

  • עבר יותר מדי זמן מאז שקיבלת את בקשת הסנכרון.

    • עליך לוודא שאתה מגיב לבקשת הסנכרון תוך 5 שניות.

ש: האם אפשר להשתמש בתגובה 'בהמתנה'?

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

בדיקה ושליחה

ש: אפשר להגדיר סביבת ענן לפיתוח?

תשובה: כן, אפשר לבדוק סביבת ענן והגדרה שלא הושקו.

שאלה: הפעולה שלי לא מופיעה בקטע 'שליטה בבית' באפליקציית Google Home. מה קורה?

תשובה: צריך לוודא שאתם מפתחים בפרויקט הזה.

מצב הדוח

שאלה: האם יש תנאים מוקדמים להטמעה של Report State?

תשובה: הפרויקט צריך להשתמש ב-Smart Home API, לתמוך ב-OAuth2 ולכלול מאפיינים עם מצבים שצריך לדווח עליהם.

שאלה: באיזו תדירות צריך לדווח על מצב המכשיר?

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

ש: האם צריך לשלוח את המצב המלא של המכשיר כשמבצעים קריאות של Report State?

תשובה: אין תמיכה בעדכונים חלקיים של מצב, ולכן קריאות ל-Report State צריכות תמיד לכלול את כל הנתונים של מאפיין מסוים שעודכן. אם שתי תכונות יוצרות חוסר עקביות, צריך לדווח עליהן יחד.

ש: האם Google יכולה לשלוח שאילתה למכשיר שלי כדי לקבל את המצב שלו (כלומר, לבצע סקר במכשיר)?

ת: זהו מנגנון חלופי שלא מומלץ להשתמש בו. אם נצטרך לחזור לבדיקת המכשיר בתדירות גבוהה עבור המשתמשים האלה, לא נוכל להבטיח מה יהיה העומס הנוסף. הצורך הזה נובע מהפלטפורמות החדשות עם תוכן חזותי. בנוסף לבעיית הטעינה הלא ידועה, חוויית המשתמש תהיה פחות טובה. אנחנו חושבים ש-Report State הוא מרכיב קריטי בפלטפורמה.

ש: אילו תכונות תומכות כרגע ב'מצב הדוח'?

תשובה: יש תמיכה בכל ה-traits הציבוריים שמשויכים אליהם מצבים. צריך לדווח גם על כל שינוי במצב המכשיר (מחובר או לא מחובר).

שימו לב: לסצנות אין מצבים. עם זאת, הן עשויות לגרום לשינוי במצב של המכשירים. אם יש מכשיר ב-Google Home Graph שהמצב שלו השתנה, צריך לדווח על כך.

ש: האם צריך לשלוח חותמת זמן עם Report State?

ת: אנחנו לא דורשים חותמת זמן. המצב האחרון שנשלח יבטל את השיחות הקודמות.

ש: האם צריך לדווח על סטטוס בנפרד אם כבר שולחים את הסטטוס בשאילתה או בפקודה לביצוע?

תשובה: Home Graph מאחסן רק את המצב שנשלח באמצעות Report State. המצב שמוחזר כתגובה לכוונות EXECUTE ו-QUERY משמש רק לתגובות קוליות למשתמש ולא מאוחסן. לכן, צריך לקרוא ל-Report State גם אם המצב החדש של המכשיר כבר הוחזר כתגובה ל-intent מסוג EXECUTE או QUERY.

ש: מהן ההשלכות של אי-הטמעה מלאה של Report State עד למועד האחרון שנקבע?

תשובה: הפעולה הזו תפגע בחוויית המשתמש, למשל בGoogle Home app (GHA) ובפלטפורמות ויזואליות. המשמעות היא שהרבה כוונות QUERY יישלחו כדי לבדוק את הסטטוס, ואין לנו אפשרות להבטיח מה יהיה העומס הנוסף על הענן של השותף.

שאלה: איך אפשר לבדוק את ההטמעה של Report State?

תשובה: אפשר להשתמש בכלי להצגת Home Graph – כלי בדיקה בשירות עצמי שמציג את מצבי המכשיר הנוכחיים שמאוחסנים ב-Home Graph.

שאלה: האם אפשר להשתמש ב-requestId אקראי עבור Report State?

ת: אנחנו ממליצים לשותפים להשתמש באותו requestId שהם קיבלו מהבקשה EXECUTE אם ה-Report State מופעל על ידי הבקשה EXECUTE. אחרת, אפשר פשוט להשתמש ב-requestId אקראי.

שאלה: אם למשתמש יש כמה מכשירים והסטטוס של אחד מהם משתנה, האם צריך לדווח על הסטטוס העדכני של כל המכשירים?

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

שיטות מומלצות

ש: מהו זמן האחזור הסביר?

תשובה: זמן התגובה האידיאלי הוא פחות מ-200 אלפיות השנייה, וזמן תגובה של 2-5 שניות הוא סביר. אם זמן האחזור הוא בסביבות 5 שניות, צריך לפנות אלינו.

שאלה: איך אפשר לגרום לרמקול עם הפעלה קולית להגיב בצורה תקינה כשהוא במצב אופליין?

תשובה: מחזירה את הסטטוס אופליין של מכשירים במצב אופליין. במקרה של השגיאה הזו, אנחנו מחזירים את הטקסט 'לא זמין כרגע' כ-TTS. מידע נוסף זמין במאמר שגיאות וחריגים.