WebUIContactCallActivatedEventArgs Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.UI.WebUI

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

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

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

Ereditarietà: Object Platform::Object IInspectable WebUIContactCallActivatedEventArgs

Attributi: ContractVersionAttribute MarshalingBehaviorAttribute

Implementazioni: IActivatedEventArgs IContactActivatedEventArgs IContactCallActivatedEventArgs 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.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
            }
        }
    }
}

Commenti

Questo oggetto viene accessibile quando si implementa un gestore eventi per WinJS.Application.Onactivated o Windows.UI.WebUI.WebUI.WebUIApplication.trigger quando ActivationKind è contatto.

Nota

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

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

Per ricevere le attivazioni delle chiamate, 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 "call". È quindi possibile specificare l'elemento "ServiceId" per specificare il tipo di chiamata al supporto. Ad esempio, se l'app gestisce le chiamate PSTN standard, è possibile specificare un "ServiceId" di "telefono". Se l'app gestisce la chiamata tramite un servizio basato sul Web, ad esempio Skype, è possibile specificare il nome di dominio di tale servizio, 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 chiamate.

Nota

Per consentire a un utente di impostare l'app come app chiamante predefinita per i numeri PSTN, l'app deve supportare anche lo schema URI "tel".

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="call" DesiredView="useLess">
        <m2:ServiceId>telephone</m2:ServiceId>
        <m2:ServiceId>skype.com</m2:ServiceId>
      </m2:LaunchAction>
    </m2:ContactLaunchActions>
  </m2:Contact>
</m2:Extension>

Dopo aver registrato il manifesto, l'app può essere attivata per il contratto di chiamata di contatto. Quando l'app viene attivata, è possibile usare le informazioni sull'evento per identificare l'attivazione della chiamata ed estrarre i parametri che consentono di completare la chiamata per l'utente.

Ecco un esempio del codice che è necessario gestire le attivazioni delle chiamate di contatto per i numeri PSTN e Gli ID Skype:

Proprietà

ActivatedOperation	Ottiene l'operazione attivata dall'app.
Contact	Ottiene il contatto per la chiamata.
Kind	Ottiene il tipo di attivazione.
PreviousExecutionState	Ottiene lo stato di esecuzione dell'app prima dell'attivazione.
ServiceId	Ottiene l'identificatore del servizio usato per la chiamata.
ServiceUserId	Ottiene l'identificatore utente del servizio usato per la chiamata.
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

Share via