为联系人启用通信操作

联系人注释描述了应用支持联系人的通信操作,例如查看个人资料、发送消息或呼叫。 本文介绍如何声明这些功能,以及 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>