מדריך אינטגרציה עם Google Assistant
אחד הדברים הראשונים שאנשים מדמיינים לעצמם כשהם שומעים "בית חכם", הינו הפעלה קולית של הבית. אז אמנם אני אישית חושב שזה עניין דיי שולי, עדיין זה מגניב להראות לחברים. במדריך זה נלמד איך לחבר את Google Assistant לבית שלנו ואז באמצעות הטלפון להפעיל, לכבות דברים. לדוגמה: Ok google, please turn on the TV
ראשית, חשוב להבהיר כי אינטגרציה עם גוגל דורשת HTTPS, ואם הHA שלכם אינו פתוח לעולם בפורט 443, זה לא יעבוד.
הדגמה:
אז בואו נתחיל להגדיר.
ראשית, יש להתקין\להוריד את התוכנה gactions-cli, אנו נשתמש בה בקרוב.
עכשיו, בואו ניצור קובץ חדש בשם project.json ונכתוב בו את התוכן הבא:
כמובן שנחליף את בסיס הכתובת ב URL לכתובת ה HA שלנו.
תחת תפריט Actions SDK box נבחר ב Build.
עכשיו, נעתיק את הפקודה שאנו רואים אשר דומה ל
./gactions update --action_package PACKAGE_NAME --project PROJECT
נחליף את PACKAGE_NAME ב project.json, ואת PROJECT באיידי של הפרוייקט שלנו בגוגל ונריץ את הפקודה מאותה תיקייה בה נמצא project.json (שימו לב שגם הספריה שהורדנו קודם, נמצאת באותו מקום).
כאשר הפקודה תסיים לרוץ, היא אמורה לפלוט כתובת אתר בדומה ל
https://console.actions.google.com/project/doctest-2d0b8/overview
פיתחו אתר זה בדפדפן.
עכשיו צריך למלא כמה פרטים. צריך למלא הכל ובהתאם להוראות, אך המידע עצמו לא חשוב כי זאת לא אפליקציה שתגישו לבדיקה של גוגל אלא לשימוש אישי בלבד.
עכשיו נלך לקובץ הקונפיגורציה שלנו configuration.yml ונגדיר בצורה הבאה
דוגמה לקובץ הקונפיגורציה:
כאשר client_id ו access_token הינם 2 מחרוזות (ארוכות!) של אותיות ומספרים בלבד.
ו project_id הוא המזהה של הפרוייקט בגוגל
לרשותכם מגריל אוטומטי (יש להגריל מחרוזות שונות לשני השדות!):
השלב האחרון בדף זה, הינו Account linking שיש לעשות אותו על מנת לבצע אינטגרציה עם HA.
Grant type - יש לבחור ב Implicit
Client Id - אותו אחד שבחרנו מקודם בהגדרות ה HA
Authorization URL -
https://[YOUR HOME ASSISTANT URL]/api/google_assistant/auth
ולהחליף את כתובת הבסיס בכתובת שלכם
בתפריט ה Configure your client ,יש להוסיף scope של name ו email.
Testing instructions - לא משנה מה יהיה שם.
בדף הראשי של האפליקציה, יש ללחוץ על Test Draft שיקח אתכם לסימולטור שלא יעבוד, אז פשוט סגרו אותו.
עכשיו פיתחו את הגדרות ה Google Assistant בטלפון וכנסו להגדרות שלו. (Settings > Home Control)
ליחצו על סימן הפלוס, ושם תראו את האפליקציה שהגדרתם כרגע.
ליחצו עליה ואשרו אותה.
זהו, שם תראו את כל המכשירים שלכם שניתן לשלוט עליהם בצורה קולית .
תהנו!
לשאלות ועזרה, ניתן לפנות אל
