google-assistant-sdk 0.6.0

google-oauthlib-tool

This tool creates test credentials to authorize devices to call the Google Assistant Service when prototyping.

• Follow the steps to configure the Actions Console project and the Google account.

• Follow the steps to register a new device model and download the client secrets file.

• Generate device credentials using 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

This tool verifies device setup for audio recording and playback.

• Install the sample’s dependencies:

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

• Record 10 seconds of audio samples and play them back:

  googlesamples-assistant-audiotest --record-time 10

• Adjust the sound device block size and flush size for a soundcard with limited throughput:

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

The same --audio-block-size and --audio-flush-size options can be used on the gRPC samples included in the SDK.

googlesamples-assistant-devicetool

This tool allows you to register Google Assistant device models and instances and associate them with Device Actions traits.

• Install the sample’s dependencies:

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

• Show the CLI tool usage:

  googlesamples-assistant-devicetool --help

• Register a new device model and new device instance (after replacing the ‘placeholder values’ between quotes):

  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'

• Register or overwrite the device model with the supported traits (after replacing the ‘placeholder values’ between quotes):

  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'

Note: The model identifier must be globally unique.

• Register or overwrite the device instance using the device model (after replacing the ‘placeholder values’ between quotes):

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

Note: The device instance identifier should be unique within the Google Developer Project associated with the device.

• Verify that the device model and instance have been registered correctly:

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

• List all device models and instances:

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

googlesamples-assistant-pushtotalk

This reference sample implements a simple but functional client for the Google Assistant Service.

• Install the sample’s dependencies:

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

• Run the push to talk sample. The sample records a voice query after a key press and plays back the Google Assistant’s answer:

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

• Try some Google Assistant voice query like “What time is it?” or “Who am I?”.

• Try a device action query like “Turn <nickname / model product name> on”.

• Run in verbose mode to see the gRPC communication with the Google Assistant Service:

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

Also see the grpc sample README.