WebUIContactVideoCallActivatedEventArgs クラス

  • リファレンス

定義

名前空間:
Windows.UI.WebUI
編集

アプリがビデオ通話の連絡先に対してアクティブ化されたときにデータを提供します。

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
属性
ContractVersionAttribute MarshalingBehaviorAttribute
実装
IActivatedEventArgs IContactActivatedEventArgs IContactVideoCallActivatedEventArgs 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.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
            }
        }
    }
}

注釈

このオブジェクトは、ActivationKind に接続しているときに WinJS.Application.Onactivated または Windows.UI.WebUI.WebUIApplication.activated イベントのイベント ハンドラーを実装するとアクセスされます。

注意

このクラスはアジャイルではありません。つまり、スレッド モデルとマーシャリング動作を考慮する必要があります。 詳細については、「 スレッドとマーシャリング (C++/CX)」を参照してください。

Windows 8.1を使用すると、ユーザーは連絡先カードまたは Windows Search エクスペリエンスから連絡先をビデオ通話できます。 連絡先ビデオ通話のアクティブ化コントラクトを実装することで、Windows はアプリを起動してユーザーにビデオ通話を行うことができます。

ビデオ通話のアクティブ化を受け取るために、アプリはマニフェストの "windows.contact" 拡張機能カテゴリに登録する必要があります。 この拡張機能の下には、"Verb" 属性が "videoCall" と等しい "LaunchAction" 要素を含める必要があります。その後、"ServiceId" 要素を指定して、アプリがビデオ通話で呼び出すことができるサービスのドメイン名を指定できます (例: "skype.com")。

このコントラクトに複数のアプリが登録されている場合、ユーザーはビデオ通話を処理するための既定値としていずれか 1 つを選択できます。

マニフェスト登録の例を次に示します。

<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 ID の連絡先ビデオ通話のアクティブ化を処理するために必要なコードの例を次に示します。

プロパティ

ActivatedOperation

アプリがアクティブ化された操作を取得します。
Contact

ビデオ通話の連絡先を取得します。
Kind

アクティブ化の種類を取得します。
PreviousExecutionState

アクティブ化される前のアプリの実行状態を取得します。
ServiceId

ビデオ通話に使用されるサービスの識別子を取得します。
ServiceUserId

ビデオ通話に使用されるサービスのユーザー識別子を取得します。
SplashScreen

スプラッシュ スクリーン からアクティブ化されたアプリへの切り替えに関する情報を提供するスプラッシュ スクリーン オブジェクトを取得します。
Verb

実行するアクションを取得します。

適用対象

こちらもご覧ください