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

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

ضبط البيئة

استخدام بيئة افتراضية في 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 على كل التعليمات البرمجية المطلوبة للحصول على يعمل "مساعد Google" على الجهاز، بما في ذلك رمز النموذج.

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

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

    Enter the authorization code:

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

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

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

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

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