Communicatieacties voor contactpersonen inschakelen

Contactannotaties beschrijven de communicatieacties die een app ondersteunt voor een contactpersoon, zoals het weergeven van een profiel, berichten verzenden of bellen. In dit artikel wordt beschreven hoe u deze mogelijkheden declareert en hoe Windows de relevante contactpersoon in uw app opent.

Voordat u begint, voegt u uw contactpersonen toe aan Windows.

Ondersteunde communicatiebewerkingen declareren

Apps kunnen de communicatiemogelijkheden aangeven die worden ondersteund voor een contactpersoon met behulp van de eigenschap SupportedOperations in ContactAnnotation.

De SupportedOperations eigenschap geeft de typen communicatieacties op die de app ondersteunt voor interactie met een contactpersoon. Deze bewerkingen worden gedefinieerd door de opsomming ContactAnnotationOperations .

Omdat ContactAnnotationOperations een opsomming van vlaggen is, kunnen meerdere bewerkingen worden gecombineerd met behulp van de binaire OF-operator (|). Hierdoor kunnen apps alle ondersteunde communicatiemogelijkheden voor een contactpersoon in één aantekening aangeven. Zie de API-verwijzing voor ContactAnnotation.SupportedOperations voor meer informatie over deze eigenschap.

In het volgende voorbeeld ziet u hoe u de ondersteunde communicatiebewerkingen voor een contactpersoon declareert.

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);

In dit voorbeeld geeft de annotatie aan Windows door dat de app ondersteuning biedt voor het weergeven van het contactprofiel, het verzenden van berichten, het maken van audio- of videogesprekken en het openen van updates voor sociale feeds voor de opgegeven contactpersoon.

Apps moeten de ondersteunde acties zo instellen dat de interactie- en communicatiemogelijkheden die beschikbaar zijn voor het contact in de app nauwkeurig worden weergegeven.

Activering van communicatie verwerken

Wanneer gebruikers een communicatieactie selecteren op een Windows-oppervlak, start Windows uw app met behulp van een geregistreerd URI-protocol en geeft het de RemoteId van de contactpersoon door aan de app.

De volgende URI-schema's komen overeen met ContactAnnotationOperations waarden.

Als een app bijvoorbeeld declareertAudioCall | VideoCall, kan Windows de app activeren met een URI, zoals:

ms-voip-video:<RemoteId>

<RemoteId> is dezelfde RemoteId waarde die u hebt opgeslagen op ContactAnnotation. Gebruik deze om de bijbehorende gebruiker of het bijbehorende gesprek in uw app te vinden en de aangevraagde ervaring te starten.

Registreer alleen URI-schema's voor bewerkingen die door uw app worden ondersteund. Windows geeft alleen een communicatieactie weer wanneer de overeenkomende protocolregistratie beschikbaar is.

Registreer de URI-schema's

Declareer elk URI-schema in het pakketmanifest als een windows.protocol extensie. In het volgende voorbeeld worden protocollen geregistreerd voor het weergeven van profielen, het verzenden van berichten, audiogesprekken en videogesprekken.

<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>

Verwante onderwerpen

• ContactAnnotation.SupportedOperations
• ContactAnnotationOperations
• ContactAnnotation.RemoteId
• uap:Protocolschemareferentie
• URI-activering afhandelen