WebUIContactCallActivatedEventArgs Класс

Определение

Пространство имен:

Windows.UI.WebUI

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

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

Наследование

Object Platform::Object IInspectable WebUIContactCallActivatedEventArgs

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute

Реализации

IActivatedEventArgs IContactActivatedEventArgs IContactCallActivatedEventArgs IActivatedEventArgsDeferral

Требования к 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.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
            }
        }
    }
}

Комментарии

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

Примечание

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

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

Чтобы получать активации звонков, приложение должно зарегистрироваться в категории расширения "windows.contact" в своем манифесте. В этом расширении необходимо включить элемент LaunchAction с атрибутом Verb, равным "call". Затем можно указать элемент ServiceId, чтобы указать тип вызова, который вы поддерживаете. Например, если приложение обрабатывает стандартные вызовы по ТСОП, можно указать ServiceId для параметра "телефон". Если приложение обрабатывает вызовы через веб-службу, например Skype, можно указать доменное имя этой службы, например "skype.com".

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

Примечание

Чтобы разрешить пользователю задать ваше приложение в качестве вызывающего по умолчанию приложения для номеров ТСОП, приложение также должно поддерживать схему URI tel.

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

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

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

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

Свойства

ActivatedOperation	Возвращает операцию, активируемую приложением.
Contact	Возвращает контакт для вызова.
Kind	Возвращает тип активации.
PreviousExecutionState	Возвращает состояние выполнения приложения до его активации.
ServiceId	Возвращает идентификатор службы, используемой для вызова .
ServiceUserId	Возвращает идентификатор пользователя службы, используемой для вызова.
SplashScreen	Возвращает объект экрана-заставки, предоставляющий сведения о переходе с экрана-заставки на активированное приложение.
Verb	Возвращает выполняемую операцию.

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

• IContactCallActivatedEventArgs
• IContactActivatedEventArgs
• IActivatedEventArgs
• IActivatedEventArgsDeferral
• Пример обработки действий с контактами