安装 SDK 和示例代码

<ph type="x-smartling-placeholder">

请按照以下说明在您的项目上安装 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

获取软件包

Google Assistant SDK 软件包中包含获取 设备上运行的 Google 助理,包括示例代码。

安装该软件包的系统依赖项:

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

    您应该会看到终端中显示的网址:

    Please visit this URL to authorize this application: https://...

  3. 复制该网址并将其粘贴到浏览器中(此操作可在任何计算机上完成)。 该页面会要求您登录 Google 账号。签名 登录你之前创建开发者项目的 Google 账号 step

  4. 从 API 批准权限请求后,系统会显示一个代码 例如“4/XXXX”。复制此代码并将其粘贴到 终端:

    Enter the authorization code:

    如果授权成功,您将看到类似于 以下:

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

    如果您看到的是 InvalidGrantError,则表示输入的验证码无效。 请重试,注意复制并粘贴完整代码。

下一步

运行示例代码