google-assistant-grpc 0.3.0

安装

• 您可以使用pip安装：

  pip install --upgrade google-assistant-grpc

授权

• 按照步骤配置 Actions Console 项目和 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

• 使用google.oauth2.credentials加载设备凭据：

  import io
  import google.oauth2.credentials
  
  with io.open('/path/to/credentials.json', 'r') as f:
      credentials = google.oauth2.credentials.Credentials(token=None,
                                                          **json.load(f))

• 使用google.auth.transport.grpc初始化 gRPC 通道。

用法

• 使用google.assistant.embedded.v1alpha1.embedded_assistant_pb2_grpc初始化 gRPC 存根：

  import google.assistant.embedded.v1alpha1.embedded_assistant_pb2_grpc
  assistant = embedded_assistant_pb2.EmbeddedAssistantStub(channel)

• 调用Assist流式传输方法。它需要一个AssistRequest生成器并返回一个AssistResponse生成器。：

  assist_responses_generator = assistant.Assist(assist_requests_generator)
  start_acquiring_audio()

• 发送带有音频配置参数的AssistRequest消息，后跟多个包含助手请求的音频数据的传出AssistRequest消息：

  import google.assistant.embedded.v1alpha1.embedded_assistant_pb2
  
  def generate_assist_requests():
      yield embedded_assistant_pb2.AssistConfig(
          audio_in_config=embedded_assistant_pb2.AudioInConfig(
              encoding='LINEAR16',
              sample_rate_hertz=16000,
          ),
          audio_out_config=embedded_assistant_pb2.AudioOutConfig(
              encoding='LINEAR16',
              sample_rate_hertz=16000,
          ),
          device_config=embedded_assistant_pb2.DeviceConfig(
              device_id=device_id,
              device_model_id=device_model_id,
          )
      )
      for data in acquire_audio_data():
          yield embedded_assistant_pb2.AssistRequest(audio_in=data)

• 处理AssistResponse消息的传入流：

  • 当接收到EventType消息设置为END_OF_UTTERANCE的AssistResponse时停止录制。

  • 从SpeechRecognitionResult字段获取用户查询的转录。

  • 从DialogStateOut字段中的 Assistant 获取对话元数据，例如补充显示文本。

  • 从AudioOut字段中提取 Assistant 响应的音频数据。

for assist_response in assist_response_generator:
    if resp.event_type == END_OF_UTTERANCE:
       stop_acquiring_audio()
    if resp.speech_results:
       print(' '.join(r.transcript for r in resp.speech_results)
    if resp.dialog_state_out.supplemental_display_text:
       print(resp.dialog_state_out.supplemental_display_text)
    if len(resp.audio_out.audio_data) > 0:
       playback_audio_data(resp.audio_out.audio_data)

参考

• gRPC 参考示例。

• 谷歌助理服务参考。

对于维护者

有关Python 包本身的开发、维护和发布的更多文档，请参阅MAINTAINER.md 。

执照

版权所有 (C) 2017 Google Inc.

根据一项或多项贡献者许可协议授权给 Apache 软件基金会 (ASF)。有关版权所有权的更多信息，请参阅随本作品分发的 NOTICE 文件。ASF 根据 Apache 许可证 2.0 版（“许可证”）将此文件许可给您；除非遵守许可，否则您不得使用此文件。您可以在以下网址获取许可证的副本

http://www.apache.org/licenses/LICENSE-2.0

除非适用法律要求或书面同意，否则根据许可分发的软件将按“原样”分发，没有任何明示或暗示的保证或条件。有关许可下的特定语言管理权限和限制，请参阅许可。