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

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

הגדרת הסביבה

שימוש בסביבה וירטואלית של 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

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

python -m pip install --upgrade google-assistant-sdk[samples]

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

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

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

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

    google-oauthlib-tool --scope https://www.googleapis.com/auth/assistant-sdk-prototype \
      --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 שבו נוצר פרויקט הפיתוח שלב.

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

    Enter the authorization code:

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

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

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

השלב הבא

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