ContactVideoCallActivatedEventArgs ContactVideoCallActivatedEventArgs ContactVideoCallActivatedEventArgs ContactVideoCallActivatedEventArgs ContactVideoCallActivatedEventArgs Class


Provides data when an app is activated to video call a contact.

JavaScript This type appears as WebUIContactVideoCallActivatedEventArgs.

public : sealed class ContactVideoCallActivatedEventArgs : IActivatedEventArgs, IContactActivatedEventArgs, IContactVideoCallActivatedEventArgs
struct winrt::Windows::ApplicationModel::Activation::ContactVideoCallActivatedEventArgs : IActivatedEventArgs, IContactActivatedEventArgs, IContactVideoCallActivatedEventArgs
public sealed class ContactVideoCallActivatedEventArgs : IActivatedEventArgs, IContactActivatedEventArgs, IContactVideoCallActivatedEventArgs
Public NotInheritable Class ContactVideoCallActivatedEventArgs Implements IActivatedEventArgs, IContactActivatedEventArgs, IContactVideoCallActivatedEventArgs
// This class does not provide a public constructor.
Windows 10 requirements
Device family
Windows Desktop Extension SDK (introduced v10.0.10240.0)
API contract
Windows.ApplicationModel.Activation.ContactActivatedEventsContract (introduced v1)


Here is an example of the code you need to handle contact video call activations for Skype Ids:

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 == "")
                var userId = videoCallArgs.ServiceUserId;
                //add video calling 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 == "")
    auto userId = videoCallArgs->ServiceUserId;
    //add video calling logic for Skype Ids


Windows 8.1 allows users to video call their contacts from the Contact Card or Windows Search experience. By implementing the contact video call activation contract, Windows can launch your app to make video calls for the user.

To receive video call activations, your app must register for the "" extension category in its manifest. Under this extension, you must include a "LaunchAction" element with the "Verb" attribute equal to "videoCall." You can then specify the "ServiceId" element to specify the domain name of the service that your app can video call over, for example ""

If multiple apps have registered for this contract, the user can choose one of them as their default for handling video calls.

Here is an example for manifest registration:

<m2:Extension Category="" xmlns:m2="">
      <m2:LaunchAction Verb="videoCall" DesiredView="useHalf">

After you register in your manifest, your app can be activated for the contact video call contract. When your app is activated, you can use the event information to identify the video call activation and extract the parameters that help you complete the video call for the user.


Contact Contact Contact Contact Contact

Gets the contact for the video call.

public : Contact Contact { get; }
Contact Contact();
public Contact Contact { get; }
Public ReadOnly Property Contact As Contact
var contact =;
Contact Contact Contact

The contact for the video call.


Use the Contact property to collect additional info about the contact that is being video called. The contact can have a name and thumbnail that can be used to represent it in your app’s UI. Or, the contact can have alternative user ids that can be used in case the primary user id is unavailable. The ConnectedServiceAccounts property contains a list of all services available for the contact. You can use the ContactConnectedServiceAccount.ServiceName and ContactConnectedServiceAccount.Id properties on each service to retrieve alternative services and user ids respectively.

Here are possible Contact properties that can be populated during a video call activation:

Kind Kind Kind Kind Kind

Gets the activation type.

public : ActivationKind Kind { get; }
ActivationKind Kind();
public ActivationKind Kind { get; }
Public ReadOnly Property Kind As ActivationKind
var activationKind = contactVideoCallActivatedEventArgs.kind;

PreviousExecutionState PreviousExecutionState PreviousExecutionState PreviousExecutionState PreviousExecutionState

Gets the execution state of the app before it was activated.

public : ApplicationExecutionState PreviousExecutionState { get; }
ApplicationExecutionState PreviousExecutionState();
public ApplicationExecutionState PreviousExecutionState { get; }
Public ReadOnly Property PreviousExecutionState As ApplicationExecutionState
var applicationExecutionState = contactVideoCallActivatedEventArgs.previousExecutionState;

ServiceId ServiceId ServiceId ServiceId ServiceId

Gets the identifier of the service used for the video call.

public : Platform::String ServiceId { get; }
winrt::hstring ServiceId();
public string ServiceId { get; }
Public ReadOnly Property ServiceId As string
var string = contactVideoCallActivatedEventArgs.serviceId;
string string string

The identifier of the service used for the video call.


Your app will only receive video call activations for ServiceIds that match the "ServiceId" elements that your app has registered in its manifest.

ServiceUserId ServiceUserId ServiceUserId ServiceUserId ServiceUserId

Gets the user identifier of the service used for the video call.

public : Platform::String ServiceUserId { get; }
winrt::hstring ServiceUserId();
public string ServiceUserId { get; }
Public ReadOnly Property ServiceUserId As string
var string = contactVideoCallActivatedEventArgs.serviceUserId;
string string string

The user identifier of the service used for the video call.


The ServiceUserId property is set to the contact’s user id for the service that is being video called over.

SplashScreen SplashScreen SplashScreen SplashScreen SplashScreen

Gets the splash screen object, which provides information about the transition from the splash screen to the activated app.

public : SplashScreen SplashScreen { get; }
SplashScreen SplashScreen();
public SplashScreen SplashScreen { get; }
Public ReadOnly Property SplashScreen As SplashScreen
var splashScreen = contactVideoCallActivatedEventArgs.splashScreen;
SplashScreen SplashScreen SplashScreen

The object that provides splash screen information.

Verb Verb Verb Verb Verb

Gets the action to be performed.

public : Platform::String Verb { get; }
winrt::hstring Verb();
public string Verb { get; }
Public ReadOnly Property Verb As string
var string = contactVideoCallActivatedEventArgs.verb;
string string string

The action to be performed.


Use the Verb property to determine the action to perform when your app is activated with ActivationKind.Contact. For video call activations, the Verb property is set to the value of Windows.ApplicationModel.Contacts.ContactLaunchActionVerbs.VideoCall.

See Also