Condividi tramite

WebUIContactVideoCallActivatedEventArgs Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.UI.WebUI
Modifica

Fornisce i dati quando un'app viene attivata per videochiamare un contatto.

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
Ereditarietà
Object Platform::Object IInspectable WebUIContactVideoCallActivatedEventArgs
Attributi
ContractVersionAttribute MarshalingBehaviorAttribute
Implementazioni
IActivatedEventArgs IContactActivatedEventArgs IContactVideoCallActivatedEventArgs IActivatedEventArgsDeferral

Requisiti Windows

Famiglia di dispositivi
Windows Desktop Extension SDK (è stato introdotto in 10.0.10240.0)
API contract
Windows.ApplicationModel.Activation.ContactActivatedEventsContract (è stato introdotto in v1.0)

Esempio

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

Commenti

Questo oggetto è accessibile quando si implementa un gestore eventi per winJS.Application.Onactivated o gli eventi Windows.UI.WebUI.WebUIApplication.activated quando ActivationKind è contatto.

Nota

Questa classe non è agile, il che significa che è necessario considerare il modello di threading e il comportamento di marshalling. Per altre info, vedi Threading e marshalling (C++/CX).

Windows 8.1 consente agli utenti di videochiamatare i propri contatti dall'esperienza Contact Card o Windows Search. Implementando il contratto di attivazione delle videochiamate di contatto, Windows può avviare l'app per effettuare videochiamate per l'utente.

Per ricevere le attivazioni di videochiamata, l'app deve registrarsi per la categoria di estensione "windows.contact" nel manifesto. In questa estensione è necessario includere un elemento "LaunchAction" con l'attributo "Verb" uguale a "videoCall". È quindi possibile specificare l'elemento "ServiceId" per specificare il nome di dominio del servizio su cui l'app può chiamare video, ad esempio "skype.com".

Se più app sono state registrate per questo contratto, l'utente può sceglierne uno come impostazione predefinita per la gestione delle videochiamate.

Ecco un esempio per la registrazione del manifesto:

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

Dopo aver eseguito la registrazione nel manifesto, l'app può essere attivata per il contratto di videochiamata del contatto. Quando l'app viene attivata, puoi usare le informazioni sull'evento per identificare l'attivazione della videochiamata ed estrarre i parametri che consentono di completare la videochiamata per l'utente.

Di seguito è riportato un esempio di codice che è necessario gestire le attivazioni di videochiamata dei contatti per Gli ID Skype:

Proprietà

ActivatedOperation

Ottiene l'operazione attivata dall'app.
Contact

Ottiene il contatto per la videochiamata.
Kind

Ottiene il tipo di attivazione.
PreviousExecutionState

Ottiene lo stato di esecuzione dell'app prima dell'attivazione.
ServiceId

Ottiene l'identificatore del servizio utilizzato per la videochiamata.
ServiceUserId

Ottiene l'identificatore utente del servizio utilizzato per la videochiamata.
SplashScreen

Ottiene l'oggetto schermata iniziale, che fornisce informazioni sulla transizione dalla schermata iniziale all'app attivata.
Verb

Ottiene l'azione da eseguire.

Si applica a

Vedi anche