虚拟助手客户端 (Android)
使用 虚拟助手客户端 应用程序 与您的虚拟助手聊天, 并将其设置为设备上的默认助手。
准备工作
-
安装 Android Studio 。
-
下载 虚拟助手客户端源代码 。
-
创建一个虚拟助手 来设置虚拟助手环境。
-
在新的虚拟助手上 启用语音
-
如果要捕捉数据,使用 Visual Studio App Center 并注启用一个新应用。
-
如果要启用身份验证,请使用 链接帐户加速器 。
创建与运行
添加应用程序设置
一共有两个配置文件用于提供环境设置。
直线语音配置
{
"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 事件 ,以利用兴趣点等基于位置的技能。
与虚拟助手互动
聊天
主界面显示了预期的用户和助手聊天窗口。 选择麦克风或键盘图标开始对话。
小工具
使用小部件,可以与设备上具有聊天体验的助手进行交互。
侧边菜单
从左侧滑动可以访问菜单。
登陆
如果我们启用了链接帐户功能, 则会出现可选的 登录 选项。
重新开始对话
使用新的对话 ID 重新开始与虚拟助手的对话。
设置
在配置文件中进行设置。
设为默认助手
将虚拟助手设置为设备的默认助手应用程序。
-
允许 Allow pemission 权限:在 Android 上覆盖此应用程序
-
选择 设备辅助应用
-
选择 虚拟助手
验证用户
如果在应用程序的配置设置中启用了链接帐户加速器 , 则侧边菜单会提供 登录 选项。
-
选择 登录 并使用关联帐户进行身份验证。
-
每个传出 Activity 中使用的用户 ID 会突出显示在顶部,旁边是一个 注销所有 按钮,该按钮将取消所有帐户与机器人的链接。 机器人上启用的每个身份验证提供程序都有一行,选择 链接 以使用该特定帐户登录。
-
链接帐户后,按钮将更改为 Unlink 。 选择 完成并返回应用程序 可以将用户 ID 传递回 Android 应用程序。
-
返回应用程序,侧边菜单现在显示 Sign out 。 以后与虚拟助手的任何对话都将传递给链接的用户 ID。
功能
该 虚拟助手客户端 允许与在默认功能中使用的技术兼容。
打开默认应用
打开默认应用程序
此方法从 OpenDefaultApp 事件中获取元数据,用于打开设备上的默认应用程序。
地图
电话
与默认拨号器兼容。
音乐
与 Spotify 兼容 。
其他功能
广播小部件更新
此功能将此事件最新信息发送到任意监听应用程序,例如 Event Companion 应用程序。
作者:陈舒怀