ContactVideoCallActivatedEventArgs Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece dados quando um aplicativo é ativado para chamar um contato por vídeo.
Javascript Esse tipo aparece como WebUIContactVideoCallActivatedEventArgs.
public ref class ContactVideoCallActivatedEventArgs sealed : IActivatedEventArgs, IContactVideoCallActivatedEventArgs/// [Windows.Foundation.Metadata.ContractVersion(Windows.ApplicationModel.Activation.ContactActivatedEventsContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ContactVideoCallActivatedEventArgs final : IActivatedEventArgs, IContactVideoCallActivatedEventArgs[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.ApplicationModel.Activation.ContactActivatedEventsContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ContactVideoCallActivatedEventArgs : IActivatedEventArgs, IContactVideoCallActivatedEventArgsPublic NotInheritable Class ContactVideoCallActivatedEventArgs
Implements IActivatedEventArgs, IContactVideoCallActivatedEventArgs- Herança
- Atributos
- Implementações
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
Aqui está um exemplo do código que você precisa para lidar com ativações de chamada de vídeo de contato para IDs do Skype.
protected override void OnActivated(IActivatedEventArgs args)
{
if (args.Kind == ActivationKind.Contact)
{
var contactArgs = args as IContactActivatedEventArgs;
if (contactArgs.Verb == Windows.ApplicationModel.Contacts.ContactLaunchActionVerbs.VideoCall)
{
IContactVideoCallActivatedEventArgs videoCallArgs = contactArgs as IContactVideoCallActivatedEventArgs;
//get contact display info
var contactName = videoCallArgs.Contact.DisplayName;
var contactThumbnail = videoCallArgs.Contact.Thumbnail;
if (videoCallArgs.ServiceId == "skype.com")
{
var userId = videoCallArgs.ServiceUserId;
//add video calling logic for Skype Ids
}
}
}
}
void App::OnActivated(Windows::ApplicationModel::Activation::IActivatedEventArgs const& args)
{
if (args.Kind() == Windows::ApplicationModel::Activation::ActivationKind::Contact)
{
auto contactArgs{ args.as<Windows::ApplicationModel::Activation::IContactActivatedEventArgs>() };
if (contactArgs.Verb() == Windows::ApplicationModel::Contacts::ContactLaunchActionVerbs::VideoCall())
{
auto videoCallArgs{ contactArgs.as<Windows::ApplicationModel::Activation::ContactVideoCallActivatedEventArgs>() };
// Get contact display info.
auto contactName{ videoCallArgs.Contact().DisplayName() };
auto contactThumbnail{ videoCallArgs.Contact().Thumbnail() };
if (videoCallArgs.ServiceId() == L"skype.com")
{
auto userId = videoCallArgs.ServiceUserId();
//add messaging logic for Skype Ids
}
}
}
}
void App::OnActivated(IActivatedEventArgs^ args)
{
if (args->Kind == ActivationKind::Contact)
{
auto contactArgs = dynamic_cast<IContactActivatedEventArgs^>(args);
if (contactArgs->Verb == Windows::ApplicationModel::Contacts::ContactLaunchActionVerbs::VideoCall)
{
auto videoCallArgs = dynamic_cast<ContactVideoCallActivatedEventArgs^>(contactArgs);
//get contact display info
auto contactName = videoCallArgs->Contact->DisplayName;
auto contactThumbnail = videoCallArgs->Contact->Thumbnail;
if (videoCallArgs->ServiceId == "skype.com")
{
auto userId = videoCallArgs->ServiceUserId;
//add video calling logic for Skype Ids
}
}
}
}
Comentários
Windows 8.1 permite que os usuários chamem seus contatos por vídeo por meio do Cartão de Visita ou da experiência do Windows Search. Ao implementar o contrato de ativação de chamada de vídeo de contato, o Windows pode iniciar seu aplicativo para fazer chamadas de vídeo para o usuário.
Para receber ativações de chamada de vídeo, 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 "videoCall". Em seguida, você pode especificar o elemento "ServiceId" para especificar o nome de domínio do serviço que seu aplicativo pode chamar por vídeo, 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 de vídeo.
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="videoCall" DesiredView="useHalf">
<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 vídeo de contato. Quando seu aplicativo é ativado, você pode usar as informações de evento para identificar a ativação de chamada de vídeo e extrair os parâmetros que ajudam você a concluir a chamada de vídeo para o usuário.
Propriedades
| Contact |
Obtém o contato da chamada de vídeo. |
| 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 de vídeo. |
| ServiceUserId |
Obtém o identificador de usuário do serviço usado para a chamada de vídeo. |
| 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. |