התקנת ה-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 שיצר את פרויקט הפיתוח בשלב הקודם.

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

    Enter the authorization code:

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

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

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

השלב הבא

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