WebUIContactVideoCallActivatedEventArgs Kelas

Definisi

Menyediakan data saat aplikasi diaktifkan untuk panggilan video kontak.

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
Warisan
Object Platform::Object IInspectable WebUIContactVideoCallActivatedEventArgs
Atribut
Penerapan

Persyaratan Windows

Rangkaian perangkat
Windows Desktop Extension SDK (diperkenalkan dalam 10.0.10240.0)
API contract
Windows.ApplicationModel.Activation.ContactActivatedEventsContract (diperkenalkan dalam v1.0)

Contoh

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

Keterangan

Objek ini diakses ketika Anda menerapkan penanganan aktivitas untuk peristiwa WinJS.Application.Onactivated atau Windows.UI.WebUI.WebUIApplication.activated ketika ActivationKindadalah kontak.

Catatan

Kelas ini tidak tangkas, yang berarti Anda perlu mempertimbangkan model utas dan perilaku marshalingnya. Untuk informasi selengkapnya, lihat Threading dan Marshaling (C++/CX).

Windows 8.1 memungkinkan pengguna untuk melakukan panggilan video kontak mereka dari pengalaman Kartu Kontak atau Windows Search. Dengan menerapkan kontrak aktivasi panggilan video kontak, Windows dapat meluncurkan aplikasi Anda untuk melakukan panggilan video bagi pengguna.

Untuk menerima aktivasi panggilan video, aplikasi Anda harus mendaftar untuk kategori ekstensi "windows.contact" dalam manifesnya. Di bawah ekstensi ini, Anda harus menyertakan elemen "LaunchAction" dengan atribut "Kata Kerja" yang sama dengan "videoCall." Anda kemudian dapat menentukan elemen "ServiceId" untuk menentukan nama domain layanan yang dapat dipanggil oleh aplikasi Anda, misalnya "skype.com."

Jika beberapa aplikasi telah mendaftar untuk kontrak ini, pengguna dapat memilih salah satu dari mereka sebagai default mereka untuk menangani panggilan video.

Berikut adalah contoh untuk pendaftaran manifes:

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

Setelah mendaftar dalam manifes, aplikasi Anda dapat diaktifkan untuk kontrak panggilan video kontak. Saat aplikasi diaktifkan, Anda dapat menggunakan informasi peristiwa untuk mengidentifikasi aktivasi panggilan video dan mengekstrak parameter yang membantu Anda menyelesaikan panggilan video untuk pengguna.

Berikut adalah contoh kode yang Anda butuhkan untuk menangani aktivasi panggilan video kontak untuk Id Skype:

Properti

ActivatedOperation

Mendapatkan operasi yang diaktifkan aplikasi.

Contact

Mendapatkan kontak untuk panggilan video.

Kind

Mendapatkan jenis aktivasi.

PreviousExecutionState

Mendapatkan status eksekusi aplikasi sebelum diaktifkan.

ServiceId

Mendapatkan pengidentifikasi layanan yang digunakan untuk panggilan video.

ServiceUserId

Mendapatkan pengidentifikasi pengguna layanan yang digunakan untuk panggilan video.

SplashScreen

Mendapatkan objek layar splash, yang menyediakan informasi tentang transisi dari layar splash ke aplikasi yang diaktifkan.

Verb

Mendapatkan tindakan yang akan dilakukan.

Berlaku untuk

Lihat juga