Partager via


WebUIContactVideoCallActivatedEventArgs Classe

Définition

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

public ref class WebUIContactVideoCallActivatedEventArgs sealed : IActivatedEventArgs, IContactVideoCallActivatedEventArgs, IActivatedEventArgsDeferral
/// [Windows.Foundation.Metadata.ContractVersion(Windows.ApplicationModel.Activation.ContactActivatedEventsContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class WebUIContactVideoCallActivatedEventArgs final : IActivatedEventArgs, IContactVideoCallActivatedEventArgs, IActivatedEventArgsDeferral
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.ApplicationModel.Activation.ContactActivatedEventsContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class WebUIContactVideoCallActivatedEventArgs : IActivatedEventArgs, IContactVideoCallActivatedEventArgs, IActivatedEventArgsDeferral
Public NotInheritable Class WebUIContactVideoCallActivatedEventArgs
Implements IActivatedEventArgs, IActivatedEventArgsDeferral, IContactVideoCallActivatedEventArgs
Héritage
Object Platform::Object IInspectable WebUIContactVideoCallActivatedEventArgs
Attributs
Implémente

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.videoCall) {

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

     if (eventObject.detail.serviceId === "skype.com") {
                var userId = eventObject.detail.serviceUserId;
  //add video 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 par vidéo à partir de l’expérience Carte de visite ou Recherche Windows. En implémentant le contrat d’activation d’appel vidéo de contact, Windows peut lancer votre application pour effectuer des appels vidéo pour l’utilisateur.

Pour recevoir des activations d’appel vidéo, 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 à « videoCall ». Vous pouvez ensuite spécifier l’élément « ServiceId » pour spécifier le nom de domaine du service sur lequel votre application peut effectuer un appel vidéo, 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 vidéo.

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="videoCall" DesiredView="useHalf">
        <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 vidéo de contact. Lorsque votre application est activée, vous pouvez utiliser les informations de l’événement pour identifier l’activation de l’appel vidéo et extraire les paramètres qui vous aident à terminer l’appel vidéo pour l’utilisateur.

Voici un exemple du code dont vous avez besoin pour gérer les activations d’appels vidéo de contact pour les ID Skype :

Propriétés

ActivatedOperation

Obtient l’opération activée par l’application.

Contact

Obtient le contact pour l’appel vidéo.

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 vidéo.

ServiceUserId

Obtient l’identificateur utilisateur du service utilisé pour l’appel vidéo.

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 à

Voir aussi