Partilhar via

WebUIContactCallActivatedEventArgs Classe

  • Referência

Definição

Namespace:
Windows.UI.WebUI
Editar

Fornece dados quando um aplicativo é ativado para chamar um contato.

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
Herança
Object Platform::Object IInspectable WebUIContactCallActivatedEventArgs
Atributos
ContractVersionAttribute MarshalingBehaviorAttribute
Implementações
IActivatedEventArgs IContactActivatedEventArgs IContactCallActivatedEventArgs IActivatedEventArgsDeferral

Requisitos do Windows

Família de dispositivos
Windows Desktop Extension SDK (introduzida na 10.0.10240.0)
API contract
Windows.ApplicationModel.Activation.ContactActivatedEventsContract (introduzida na v1.0)

Exemplos

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

Comentários

Esse objeto é acessado quando você implementa um manipulador de eventos para os eventos WinJS.Application.Onactivated ou Windows.UI.WebUI.WebUIApplication.activated quando ActivationKind é contatado.

Observação

Essa classe não é ágil, o que significa que você precisa considerar seu modelo de threading e o comportamento de marshaling. Para obter mais informações, consulte Threading e marshaling (C++/CX).

Windows 8.1 permite que os usuários liguem para seus contatos por meio do Cartão de Visita ou da experiência do Windows Search. Ao implementar o contrato de ativação de chamada de contato, o Windows pode iniciar seu aplicativo para fazer chamadas para o usuário.

Para receber ativações de chamada, seu aplicativo deve se registrar para a categoria de extensão "windows.contact" em seu manifesto. Nessa extensão, você deve incluir um elemento "LaunchAction" com o atributo "Verbo" igual a "call". Em seguida, você pode especificar o elemento "ServiceId" para especificar o tipo de chamada compatível. Por exemplo, se seu aplicativo manipular chamadas PSTN padrão, você poderá especificar uma "ServiceId" de "telefone". Se o aplicativo lidar com chamadas em um serviço baseado na Web, como o Skype, você poderá especificar o nome de domínio desse serviço, por exemplo, "skype.com".

Se vários aplicativos tiverem se registrado para esse contrato, o usuário poderá escolher um deles como padrão para lidar com chamadas.

Observação

Para permitir que um usuário defina seu aplicativo como seu aplicativo de chamada padrão para números PSTN, seu aplicativo também deve dar suporte ao esquema de URI "tel".

Aqui está um exemplo de registro de 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>

Depois que você se registrar no manifesto, seu aplicativo poderá ser ativado para o contrato de chamada de contato. Quando seu aplicativo é ativado, você pode usar as informações do evento para identificar a ativação da chamada e extrair os parâmetros que ajudam você a concluir a chamada para o usuário.

Aqui está um exemplo do código que você precisa para lidar com ativações de chamada de contato para números PSTN e IDs do Skype:

Propriedades

ActivatedOperation

Obtém a operação ativada pelo aplicativo.
Contact

Obtém o contato da chamada.
Kind

Obtém o tipo de ativação.
PreviousExecutionState

Obtém o estado de execução do aplicativo antes de ser ativado.
ServiceId

Obtém o identificador do serviço usado para a chamada.
ServiceUserId

Obtém o identificador de usuário do serviço usado para a chamada.
SplashScreen

Obtém o objeto de tela inicial, que fornece informações sobre a transição da tela inicial para o aplicativo ativado.
Verb

Obtém a ação a ser executada.

Aplica-se a

Confira também