google-assistant-sdk 0.6.0

google-oauthlib-tool

此工具用于在原型设计时创建测试凭据，以便授权设备调用Google助手服务。

• 按照以下步骤配置动作控制台项目和Google账户。

• 按照以下步骤注册新的设备模型并下载客户端密钥文件。

• 使用google-oauthlib-tool生成设备凭据

  pip install –upgrade google-auth-oauthlib[tool] google-oauthlib-tool –client-secrets path/to/client_secret_<client-id>.json –scope https://www.googleapis.com/auth/assistant-sdk-prototype –save –headless

googlesamples-assistant-audiotest

此工具验证设备设置，以便进行音频录制和播放。

• 安装示例的依赖项

  sudo apt-get install portaudio19-dev libffi-dev libssl-dev
  pip install --upgrade google-assistant-sdk[samples]

• 录制10秒的音频样本并播放它们

  googlesamples-assistant-audiotest --record-time 10

• 调整有限吞吐量的声卡的音频块大小和刷新大小

  googlesamples-assistant-audiotest --record-time 10 --audio-block-size=3200 --audio-flush-size=6400

相同的--audio-block-size和--audio-flush-size选项可用于SDK中包含的gRPC示例。

googlesamples-assistant-devicetool

此工具允许您注册Google助手设备模型和实例，并将它们与设备动作特性关联。

• 安装示例的依赖项

  sudo apt-get install portaudio19-dev libffi-dev libssl-dev
  pip install --upgrade google-assistant-sdk[samples]

• 显示CLI工具用法

  googlesamples-assistant-devicetool --help

• 注册新的设备模型和新的设备实例（在引号之间的占位符值替换后）

  googlesamples-assistant-devicetool --project-id PROJECT_ID register --model 'my-model-identifier' \
                                                                      --type LIGHT --trait action.devices.traits.OnOff \
                                                                      --manufacturer 'Assistant SDK developer' \
                                                                      --product-name 'Assistant SDK light' \
                                                                      --description 'Assistant SDK light device' \
                                                                      --device 'my-device-identifier' \
                                                                      --nickname 'My Assistant Light'

• 注册或覆盖具有支持特性的设备模型（在引号之间的占位符值替换后）

  googlesamples-assistant-devicetool --project-id PROJECT_ID register-model --model 'my-model-identifier' \
                                                                            --type LIGHT --trait action.devices.traits.OnOff \
                                                                            --manufacturer 'Assistant SDK developer' \
                                                                            --product-name 'Assistant SDK light' \
                                                                            --description 'Assistant SDK light device'

注意：模型标识符必须是全局唯一的。

• 使用设备模型注册或覆盖设备实例（在引号之间的占位符值替换后）

  googlesamples-assistant-devicetool --project-id PROJECT_ID register-device --device 'my-device-identifier' \
                                                                             --model 'my-model-identifier' \
                                                                             --nickname 'My Assistant Light'

注意：设备实例标识符应在与设备关联的Google开发者项目中是唯一的。

• 验证设备模型和实例是否已正确注册

  googlesamples-assistant-devicetool --project-id PROJECT_ID get --model 'my-model-identifier'
  googlesamples-assistant-devicetool --project-id PROJECT_ID get --device 'my-device-identifier'

• 列出所有设备模型和实例

  googlesamples-assistant-devicetool --project-id PROJECT_ID list --model
  googlesamples-assistant-devicetool --project-id PROJECT_ID list --device

googlesamples-assistant-pushtotalk

此参考示例实现了对Google助手服务的简单但功能性的客户端。

• 安装示例的依赖项

  sudo apt-get install portaudio19-dev libffi-dev libssl-dev
  pip install --upgrade google-assistant-sdk[samples]

• 运行“按谈”示例。该示例在按键后记录语音查询并播放Google助手的回答

  googlesamples-assistant-pushtotalk --device-model-id 'my-device-model' --device-id 'my-device-identifier'

• 尝试一些Google助手语音查询，例如“现在几点？”或“我是谁？”。

• 尝试设备动作查询，例如“打开<昵称/模型产品名称>”。

• 以详细模式运行以查看与Google助手服务的gRPC通信

  googlesamples-assistant-pushtotalk --device-model-id 'my-device-model' --device-id 'my-device-identifier' -v

另请参阅grpc示例README。