安裝 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，代表輸入的代碼無效。 再試一次，謹慎複製及貼上完整程式碼。

後續步驟

執行程式碼範例