WebUIContactCallActivatedEventArgs Classe

Référence

Définition

Espace de noms:: Windows.UI.WebUI

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Fournit des données lorsqu’une application est activée pour appeler un contact.

public ref class WebUIContactCallActivatedEventArgs sealed : IActivatedEventArgs, IContactCallActivatedEventArgs, IActivatedEventArgsDeferral

/// [Windows.Foundation.Metadata.ContractVersion(Windows.ApplicationModel.Activation.ContactActivatedEventsContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class WebUIContactCallActivatedEventArgs final : IActivatedEventArgs, IContactCallActivatedEventArgs, IActivatedEventArgsDeferral

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.ApplicationModel.Activation.ContactActivatedEventsContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class WebUIContactCallActivatedEventArgs : IActivatedEventArgs, IContactCallActivatedEventArgs, IActivatedEventArgsDeferral

Public NotInheritable Class WebUIContactCallActivatedEventArgs
Implements IActivatedEventArgs, IActivatedEventArgsDeferral, IContactCallActivatedEventArgs

Héritage: Object Platform::Object IInspectable WebUIContactCallActivatedEventArgs

Attributs: ContractVersionAttribute MarshalingBehaviorAttribute

Implémente: IActivatedEventArgs IContactActivatedEventArgs IContactCallActivatedEventArgs IActivatedEventArgsDeferral

Configuration requise pour Windows

Famille d’appareils	Windows Desktop Extension SDK (introduit dans 10.0.10240.0)
API contract	Windows.ApplicationModel.Activation.ContactActivatedEventsContract (introduit dans v1.0)

Exemples

JavaScript

function activated(eventObject) {
    if (eventObject.detail.kind === Windows.ApplicationModel.Activation.ActivationKind.contact) {
        if (eventObject.detail.verb === Windows.ApplicationModel.Contacts.ContactLaunchActionVerbs.call) {

     //get contact display info
            var contactName = eventObject.detail.contact.displayName;
            var contactThumbnail = eventObject.detail.contact.thumbnail;

            if (eventObject.detail.serviceId === "telephone") {
                var phoneNumber = eventObject.detail.serviceUserId;
  //add calling logic for PSTN numbers
            }
     else if (eventObject.detail.serviceId === "skype.com") {
                var userId = eventObject.detail.serviceUserId;
  //add calling logic for Skype Ids
            }
        }
    }
}

Remarques

Cet objet est accessible lorsque vous implémentez un gestionnaire d’événements pour les événements WinJS.Application.Onactivated ou Windows.UI.WebUI.WebUIApplication.activated lorsque ActivationKind est en contact.

Notes

Cette classe n’est pas agile, ce qui signifie que vous devez prendre en compte son modèle de thread et son comportement de marshaling. Pour plus d’informations, consultez Threading and Marshaling (C++/CX).

Windows 8.1 permet aux utilisateurs d’appeler leurs contacts à partir de l’expérience Carte de visite ou Recherche Windows. En implémentant le contrat d’activation des appels de contact, Windows peut lancer votre application pour passer des appels pour l’utilisateur.

Pour recevoir des activations d’appel, votre application doit s’inscrire à la catégorie d’extension « windows.contact » dans son manifeste. Sous cette extension, vous devez inclure un élément « LaunchAction » avec l’attribut « Verb » égal à « call ». Vous pouvez ensuite spécifier l’élément « ServiceId » pour spécifier le type d’appel pris en charge. Par exemple, si votre application gère les appels RTC standard, vous pouvez spécifier un « ServiceId » de « téléphone ». Si votre application gère l’appel via un service web, comme Skype, vous pouvez spécifier le nom de domaine de ce service, par exemple « skype.com ».

Si plusieurs applications se sont inscrites pour ce contrat, l’utilisateur peut choisir l’une d’elles par défaut pour la gestion des appels.

Notes

Pour permettre à un utilisateur de définir votre application comme application d’appel par défaut pour les numéros RTC, votre application doit également prendre en charge le schéma d’URI « tel ».

Voici un exemple d’inscription de manifeste :

<m2:Extension Category="windows.contact" xmlns:m2="http://schemas.microsoft.com/appx/2013/manifest">
  <m2:Contact>
    <m2:ContactLaunchActions>
      <m2:LaunchAction Verb="call" DesiredView="useLess">
        <m2:ServiceId>telephone</m2:ServiceId>
        <m2:ServiceId>skype.com</m2:ServiceId>
      </m2:LaunchAction>
    </m2:ContactLaunchActions>
  </m2:Contact>
</m2:Extension>

Une fois que vous vous êtes inscrit dans votre manifeste, votre application peut être activée pour le contrat d’appel de contact. Lorsque votre application est activée, vous pouvez utiliser les informations de l’événement pour identifier l’activation de l’appel et extraire les paramètres qui vous aident à terminer l’appel pour l’utilisateur.

Voici un exemple de code dont vous avez besoin pour gérer les activations d’appels de contact pour les numéros RTC et les ID Skype :

Propriétés

ActivatedOperation	Obtient l’opération activée par l’application.
Contact	Obtient le contact pour l’appel.
Kind	Obtient le type d’activation.
PreviousExecutionState	Obtient l’état d’exécution de l’application avant son activation.
ServiceId	Obtient l’identificateur du service utilisé pour l’appel.
ServiceUserId	Obtient l’identificateur utilisateur du service utilisé pour l’appel.
SplashScreen	Obtient l’objet d’écran de démarrage, qui fournit des informations sur la transition de l’écran de démarrage vers l’application activée.
Verb	Obtient l’action à effectuer.

S’applique à

Partager via