虚拟助手客户端 (Android)

使用 虚拟助手客户端 应用程序 与您的虚拟助手聊天, 并将其设置为设备上的默认助手。

准备工作

  1. 安装 Android Studio 。
  2. 下载 虚拟助手客户端源代码 。
  3. 创建一个虚拟助手 来设置虚拟助手环境。
  4. 在新的虚拟助手上 启用语音
  5. 如果要捕捉数据,使用 Visual Studio App Center 并注启用一个新应用。
  6. 如果要启用身份验证,请使用 链接帐户加速器 。

创建与运行

添加应用程序设置

一共有两个配置文件用于提供环境设置。

直线语音配置
{
  "SpeechSubscriptionKey": "SPEECH_SERVICE_SUBSCRIPTION_KEY", // Replace with your Speech Service subscription key
  "SpeechRegion": "westus2",
  "CustomCommandsAppId": "", // Optional, if you are connecting to a Custom Commands application
  "CustomVoiceDeploymentIds": "", // Optional, to point to custom voices
  "CustomSREndpointId": "", // Optional, to point to a customized speech recognition endpoint
  "TTSBargeInSupported": false, // Whether or not to listen to keyword while TTS is playing. If true, TTS playback stops once Keyword is verified.
  "SpeechSDKLogEnabled": false, // Optional, whether to log Direct Line Speech activites. The default file path is on the device internal storage at Android/data/com.microsoft.bot.builder.solutions.virtualassistant/files/SpeechSDK.log
  "UserId": "android",
  "UserName": "Android",
  "SRLanguage": "en-us",
  "Keyword": "computer",
  "EnableKWS": false, // Keyword spotting
  "LinkedAccountEndpoint": "" // Optional if you enabled the Linked Accounts solution in the prerequisites
}

用户ID 是由用户生成的所有消息的唯一标识符,这个可以与 链接帐户样品 结合。

应用配置
{
  "history_linecount": 2147483646,
  "show_full_conversation": true,
  "enable_dark_mode": false,
  "keep_screen_on": true,
  "app_center_id": "APP_CENTER_ID" // Replace with your Visual Studio App Center id
}
可选功能: 聊天颜色
<?xml version="1.0" encoding="utf-8"?>
<resources>
...
    <!-- Chat -->
    <color name="color_chat_text_bot">#000000</color>
    <color name="color_chat_text_user">#ffffff</color>
    <color name="color_chat_background_bot">#f2f2f2</color>
    <color name="color_chat_background_user">#3062d6</color>
...
</resources>

运行

创建并运行应用程序 用于部署 Android 模拟器或连接的设备。

权限
录制音频

用户向机器人发出语音请求时需要。 有了这个,我们就可以只使用键盘操作。

位置功能

允许虚拟助手接收带有GPS坐标的 VA.Location 事件 ,以利用兴趣点等基于位置的技能。

与虚拟助手互动

聊天

主界面显示了预期的用户和助手聊天窗口。 选择麦克风或键盘图标开始对话。

安卓app在虚拟容器抓取和发送数据 安卓虚拟助手_Android

小工具

使用小部件,可以与设备上具有聊天体验的助手进行交互。

安卓app在虚拟容器抓取和发送数据 安卓虚拟助手_安卓app在虚拟容器抓取和发送数据_02

侧边菜单

从左侧滑动可以访问菜单。

安卓app在虚拟容器抓取和发送数据 安卓虚拟助手_Android_03

登陆

如果我们启用了链接帐户功能, 则会出现可选的 登录 选项。

重新开始对话

使用新的对话 ID 重新开始与虚拟助手的对话。

设置

在配置文件中进行设置。

安卓app在虚拟容器抓取和发送数据 安卓虚拟助手_客户端_04

设为默认助手

将虚拟助手设置为设备的默认助手应用程序。

  1. 允许 Allow pemission 权限:在 Android 上覆盖此应用程序
  2. 安卓app在虚拟容器抓取和发送数据 安卓虚拟助手_Android_05

  3. 选择 设备辅助应用
  4. 安卓app在虚拟容器抓取和发送数据 安卓虚拟助手_应用程序_06

  5. 选择 虚拟助手
  6. 安卓app在虚拟容器抓取和发送数据 安卓虚拟助手_java_07

验证用户

如果在应用程序的配置设置中启用了链接帐户加速器 , 则侧边菜单会提供 登录 选项。

  1. 选择 登录 并使用关联帐户进行身份验证。
  2. 安卓app在虚拟容器抓取和发送数据 安卓虚拟助手_java_08

  3. 每个传出 Activity 中使用的用户 ID 会突出显示在顶部,旁边是一个 注销所有 按钮,该按钮将取消所有帐户与机器人的链接。 机器人上启用的每个身份验证提供程序都有一行,选择 链接 以使用该特定帐户登录。
  4. 安卓app在虚拟容器抓取和发送数据 安卓虚拟助手_Android_09

  5. 链接帐户后,按钮将更改为 Unlink 。 选择 完成并返回应用程序 可以将用户 ID 传递回 Android 应用程序。
  6. 安卓app在虚拟容器抓取和发送数据 安卓虚拟助手_java_10

  7. 返回应用程序,侧边菜单现在显示 Sign out 。 以后与虚拟助手的任何对话都将传递给链接的用户 ID。
  8. 安卓app在虚拟容器抓取和发送数据 安卓虚拟助手_java_11

功能

虚拟助手客户端 允许与在默认功能中使用的技术兼容。

打开默认应用

打开默认应用程序

此方法从 OpenDefaultApp 事件中获取元数据,用于打开设备上的默认应用程序。

地图

兼容 Waze 或 Google 地图 。

电话

与默认拨号器兼容。

音乐

与 Spotify 兼容 。

其他功能

广播小部件更新

此功能将此事件最新信息发送到任意监听应用程序,例如 Event Companion 应用程序。

作者:陈舒怀