安装 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

获取软件包

Google 助理 SDK 软件包中包含在设备上运行 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

    您应该会在终端中看到一个网址:

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

  3. 复制网址并将其粘贴到浏览器中(可在任何系统上完成)。 该页面会要求您登录自己的 Google 账号。登录在上一 步骤

  4. 从 API 批准权限请求后,您的浏览器会显示代码,例如“4/XXXX”。复制此代码并将其粘贴到终端中:

    Enter the authorization code:

    如果授权成功,您将看到类似于以下内容的响应:

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

    如果您看到 InvalidGrantError,则表示输入的验证码无效。请重试,但请务必复制并粘贴整段代码。

后续步骤

运行示例代码