Kişiler için iletişim eylemlerini etkinleştir

Kişi ek açıklamalar, bir uygulamanın bir kişi için desteklediği profil görüntüleme, mesajlaşma veya arama gibi iletişim eylemlerini açıklar. Bu makalede bu özelliklerin nasıl bildirileceği ve Windows'un ilgili kişiyi uygulamanızda nasıl açacağı gösterilmektedir.

Başlamadan önce kişilerinizi Windows'a ekleyin.

Desteklenen iletişim işlemlerini tanımlama

Uygulamalar, SupportedOperations özelliğini ContactAnnotation üzerinde kullanarak bir kişi için desteklenen iletişim yeteneklerini bildirebilir.

SupportedOperations özelliği, uygulamanın bir kişiyle etkileşim kurmak için desteklediği iletişim eylemi türlerini belirtir. Bu işlemler ContactAnnotationOperations numaralandırma türü tarafından tanımlanır.

Bir ContactAnnotationOperations flags numaralandırması olduğundan, ikili OR (|) operatörü kullanılarak birden çok işlem birleştirilebilir. Bu, uygulamaların tek bir ek açıklamadaki bir kişi için desteklenen tüm iletişim özelliklerini belirtmesine olanak tanır. Bu özellik hakkında daha fazla bilgi için bkz. ContactAnnotation.SupportedOperations için API başvurusu.

Aşağıdaki örnekte, bir kişi için desteklenen iletişim işlemlerinin nasıl bildirlendiği gösterilmektedir.

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

Bu örnekte ek açıklama, uygulamanın kişi profilini görüntülemeyi, ileti göndermeyi, sesli veya görüntülü arama yapmayı ve belirtilen kişi için sosyal akış güncelleştirmelerine erişmeyi desteklediğini Windows'a bildirir.

Uygulamalar, uygulama içindeki ilgili kişi için kullanılabilir etkileşim ve iletişim özelliklerini doğru bir şekilde temsil etmek için desteklenen işlemleri ayarlamalıdır.

İletişim etkinleştirmesini işle

Kullanıcılar bir Windows yüzeyinden iletişim eylemi seçtiğinde, Windows kayıtlı bir URI protokolü kullanarak uygulamanızı başlatır ve kişinin RemoteId bilgisini uygulamaya iletir.

Aşağıdaki URI düzenleri, ContactAnnotationOperations değerlerine karşılık gelir.

Operation URI düzeni SupportedOperations bayrağı
Call ms-voip-call: AudioCall
Video ms-voip-video: VideoCall
Message ms-ipmessaging: Message
Profile ms-contact-profile: ContactProfile

Örneğin, bir uygulama AudioCall | VideoCall tanımlıyorsa Windows, uygulamayı aşağıdaki gibi bir URI ile etkinleştirebilir:

ms-voip-video:<RemoteId>

<RemoteId>, RemoteId üzerinde depoladığınız aynı ContactAnnotation değerdir. Uygulamanızda ilgili kullanıcıyı veya konuşmayı bulmak ve istenen deneyimi başlatmak için bunu kullanın.

URI şemalarını yalnızca uygulamanızın desteklediği işlemler için kaydedin. Windows yalnızca eşleşen protokol kaydı kullanılabilir olduğunda iletişim eylemini gösterir.

URI şemalarını kaydet

Paket bildirimindeki her URI şemasını bir windows.protocol uzantısı olarak bildirin. Aşağıdaki örnek, profil görüntüleme, mesajlaşma, sesli arama ve görüntülü arama için protokolleri tanımlar.

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

İlgili içerik

  • Son güncelleştirme: