התקנת ה-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 שהורדתם באחת מהגרסאות הקודמות שלב; ייתכן שתצטרכו להעתיק את המכשיר. אין לשנות את השם של הקובץ הזה.

    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, סימן שהוזן קוד לא חוקי. מנסים שוב, ומקפידים להעתיק ולהדביק את הקוד כולו.

השלב הבא

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