联系人注释描述了应用支持联系人的通信操作,例如查看个人资料、发送消息或呼叫。 本文介绍如何声明这些功能,以及 Windows 如何在应用中打开相关联系人。
在开始之前,请将你的联系人添加到 Windows。
声明支持的通信操作
应用可以使用 ContactAnnotation 上的 SupportedOperations 属性声明联系人支持的通信功能。
该 SupportedOperations 属性指定应用支持与联系人交互的通信操作类型。 这些操作由 ContactAnnotationOperations 枚举定义。
由于 ContactAnnotationOperations 是标志枚举,因此可以使用二进制 OR (|) 运算符组合多个操作。 这允许应用在单个批注中指示联系人支持的所有通信功能。 有关此属性的详细信息,请参阅 ContactAnnotation.SupportedOperations 的 API 参考。
以下示例演示如何声明联系人支持的通信操作。
var annotation = new ContactAnnotation
{
ContactId = contact.Id,
RemoteId = contact.RemoteId,
SupportedOperations =
ContactAnnotationOperations.ContactProfile |
ContactAnnotationOperations.Message |
ContactAnnotationOperations.AudioCall |
ContactAnnotationOperations.VideoCall |
ContactAnnotationOperations.SocialFeeds
};
await this.contactAnnotationList.TrySaveAnnotationAsync(annotation);
在此示例中,注释向 Windows 声明该应用支持查看联系人配置文件、发送消息、进行音频或视频通话,以及访问指定联系人的社交源更新。
应用应设置支持的操作,以准确表示应用中联系人可用的交互和通信功能。
句柄通信激活
当用户从 Windows 界面选择通信操作时,Windows 会通过已注册的 URI 协议启动你的应用,并将联系人的 RemoteId 传递给该应用。
以下 URI 方案对应于 ContactAnnotationOperations 值。
| Operation | URI 协议 |
SupportedOperations 标志 |
|---|---|---|
| Call | ms-voip-call: |
AudioCall |
| 视频 | ms-voip-video: |
VideoCall |
| 消息 | ms-ipmessaging: |
Message |
| Profile | ms-contact-profile: |
ContactProfile |
例如,如果应用声明 AudioCall | VideoCall,Windows 可以使用如下 URI 激活该应用:
ms-voip-video:<RemoteId>
<RemoteId>与您存储在 ContactAnnotation 上的 RemoteId 值相同。 使用它在应用中找到相应的用户或对话,并启动所请求的体验。
仅为应用支持的操作注册 URI 方案。 仅当匹配的协议注册可用时,Windows才会显示通信操作。
注册 URI 方案
将包清单中的每个 URI 方案声明为 windows.protocol 扩展。 以下示例注册用于个人资料查看、消息传送、音频通话和视频通话的协议。
<Extensions>
<uap:Extension Category="windows.protocol">
<uap:Protocol Name="ms-contact-profile">
<uap:DisplayName>TestProfileApp</uap:DisplayName>
</uap:Protocol>
</uap:Extension>
<uap:Extension Category="windows.protocol">
<uap:Protocol Name="ms-ipmessaging">
<uap:DisplayName>TestMsgApp</uap:DisplayName>
</uap:Protocol>
</uap:Extension>
<uap:Extension Category="windows.protocol">
<uap:Protocol Name="ms-voip-video">
<uap:DisplayName>TestVideoApp</uap:DisplayName>
</uap:Protocol>
</uap:Extension>
<uap:Extension Category="windows.protocol">
<uap:Protocol Name="ms-voip-call">
<uap:DisplayName>TestCallApp</uap:DisplayName>
</uap:Protocol>
</uap:Extension>
</Extensions>