התקנת ה-SDK וקוד לדוגמה

כדי להתקין את ה-SDK ואת הקוד לדוגמה בפרויקט, פועלים לפי ההוראות הבאות. הפעל את כל הפקודות בדף הזה במסוף במכשיר (באופן ישיר או באמצעות חיבור SSH).

הגדרת סביבה וירטואלית חדשה של Python

שימוש בסביבה וירטואלית של Python כדי לבודד את ה-SDK ואת יחסי התלות שלו מחבילות ה-Python של המערכת.

(מומלץ) ב-Python 3:

sudo apt-get update
sudo apt-get install python3-dev python3-venv # Use python3.4-venv if the package cannot be found.
python3 -m venv env
env/bin/python -m pip install --upgrade pip setuptools wheel
source env/bin/activate

ב-Python 2.7:

sudo apt-get update
sudo apt-get install python-dev python-virtualenv
virtualenv env --no-site-packages
env/bin/python -m pip install --upgrade pip setuptools wheel
source env/bin/activate

לקבלת החבילה

חבילת ה-SDK של Google Assistant מכילה את כל הקוד הנדרש כדי לקבל את Google Assistant פועלת במכשיר, כולל הקוד לדוגמה.

מתקינים את יחסי התלות של מערכת החבילה: 

sudo apt-get install portaudio19-dev libffi-dev libssl-dev libmpg123-dev

יש להשתמש ב-pip כדי להתקין את הגרסה האחרונה של חבילת Python בסביבה הווירטואלית: 

python -m pip install --upgrade google-assistant-library==1.0.1
python -m pip install --upgrade google-assistant-sdk[samples]==0.5.1

יצירת פרטי כניסה

  1. מתקינים או מעדכנים את כלי ההרשאות: 

    python -m pip install --upgrade google-auth-oauthlib[tool]

  2. יצירת פרטי כניסה כדי להריץ את הקוד והכלים לדוגמה. אפליקציות עזר קובץ ה-JSON שהורדתם בשלב הקודם. ייתכן שיהיה צורך להעתיק אותו אל המכשיר. אין לשנות את השם של הקובץ הזה.

    google-oauthlib-tool --scope https://www.googleapis.com/auth/assistant-sdk-prototype \
      --scope https://www.googleapis.com/auth/gcm \
      --save --headless --client-secrets /path/to/client_secret_client-id.json

    כתובת ה-URL אמורה להופיע בטרמינל: 

    Please visit this URL to authorize this application: https://...

  3. מעתיקים את כתובת ה-URL ומדביקים אותה בדפדפן (ניתן לעשות זאת בכל מחשב). בדף תופיע בקשה להיכנס לחשבון Google. הסמל לחשבון Google שבו נוצר פרויקט הפיתוח step.

  4. אחרי שתאשרו את בקשת ההרשאה מה-API, יופיע קוד בדפדפן, למשל "4/XXXX". צריך להעתיק את הקוד הזה ולהדביק אותו טרמינל:

    Enter the authorization code:

    אם ההרשאה הצליחה, תופיע תגובה שדומה לזו: הבאים:

    credentials saved: /path/to/.config/google-oauthlib-tool/credentials.json

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

השלב הבא

הרצת הקוד לדוגמה