Поделиться через


WebUIContactVideoCallActivatedEventArgs Класс

Определение

Предоставляет данные при активации приложения для видеозвонка контакта.

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
Наследование
Object Platform::Object IInspectable WebUIContactVideoCallActivatedEventArgs
Атрибуты
Реализации

Требования к Windows

Семейство устройств
Windows Desktop Extension SDK (появилось в 10.0.10240.0)
API contract
Windows.ApplicationModel.Activation.ContactActivatedEventsContract (появилось в v1.0)

Примеры

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

Комментарии

Доступ к этому объекту осуществляется при реализации обработчика событий для событий WinJS.Application.Onactivated или Windows.UI.WebUI.WebUIApplication.activated , когда ActivationKind является контактом.

Примечание

Этот класс не является гибким. Это означает, что необходимо учитывать его модель потоков и поведение маршалинга. Дополнительные сведения см. в разделе Потоки и маршалинг (C++/CX).

Windows 8.1 позволяет пользователям звонить по видеозвонку своим контактам из карточки контакта или интерфейса Поиска Windows. Реализуя контракт активации видеозвонка контакта, Windows может запустить приложение для выполнения видеозвонков для пользователя.

Чтобы получать активации видеовызовов, приложение должно зарегистрироваться в категории расширения "windows.contact" в своем манифесте. В этом расширении необходимо включить элемент LaunchAction с атрибутом Verb, равным videoCall. Затем можно указать элемент ServiceId, чтобы указать доменное имя службы, через которую приложение может выполнять видеозвонки, например "skype.com".

Если для этого контракта зарегистрировано несколько приложений, пользователь может выбрать одно из них по умолчанию для обработки видеозвонков.

Ниже приведен пример регистрации манифеста:

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

После регистрации в манифесте приложение можно активировать для контракта видеозвонка контакта. При активации приложения можно использовать сведения о событии, чтобы определить активацию видеозвонка и извлечь параметры, которые помогут вам выполнить видеозвонок для пользователя.

Ниже приведен пример кода, необходимого для обработки активации видеозвонка для идентификаторов Skype:

Свойства

ActivatedOperation

Возвращает операцию, активируемую приложением.

Contact

Возвращает контакт для видеозвонка.

Kind

Возвращает тип активации.

PreviousExecutionState

Возвращает состояние выполнения приложения до его активации.

ServiceId

Возвращает идентификатор службы, используемой для видеозвонка.

ServiceUserId

Возвращает идентификатор пользователя службы, используемой для видеозвонка.

SplashScreen

Возвращает объект экрана-заставки, предоставляющий сведения о переходе с экрана-заставки на активированное приложение.

Verb

Возвращает выполняемую операцию.

Применяется к

См. также раздел