تثبيت حزمة تطوير البرامج (SDK) والرمز النموذجي

اتبع هذه التعليمات لتثبيت SDK ونموذج للرمز في مشروعك. شغِّل كل الأوامر في هذه الصفحة في وحدة طرفية على الجهاز (إما مباشرةً أو عبر اتصال SSH).

ضبط البيئة

استخدم بيئة Python الافتراضية لعزل حزمة SDK وتبعياتها عن حزم بايثون للنظام.

(موصى به) بالنسبة إلى 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" على جميع الرموز البرمجية المطلوبة لتشغيل "مساعد Google" على الجهاز، بما في ذلك الرمز النموذجي.

ثبِّت تبعيات نظام الحزمة: 

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

يمكنك استخدام pip لتثبيت أحدث إصدار من حزمة بايثون في البيئة الافتراضية: 

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. بعد الموافقة على طلب الإذن من واجهة برمجة التطبيقات، سيظهر رمز في متصفحك، مثل "4/XXXX". انسخ هذه التعليمة البرمجية ولصقها في المحطة الطرفية:

    Enter the authorization code:

    إذا كان التفويض ناجحًا، سيظهر لك ردّ مشابه لما يلي:

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

    إذا رأيت InvalidGrantError بدلاً من ذلك، هذا يعني أنه تم إدخال رمز غير صالح. يُرجى إعادة المحاولة مع الحرص على نسخ الرمز بالكامل ولصقه.

الخطوة التالية

تشغيل الرمز النموذجي