安裝 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. 產生憑證以執行程式碼範例和工具。參照上一個 步驟； 您可能需要複製裝置。不要重新命名這個檔案。

    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，表示輸入的代碼無效。 請複製及貼上整個程式碼，然後再試一次。

後續步驟

執行程式碼範例