ContactVideoCallActivatedEventArgs Kelas

Referensi

Definisi

Ruang nama:: Windows.ApplicationModel.Activation

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Edit

Menyediakan data saat aplikasi diaktifkan untuk panggilan video kontak.

Javascript Jenis ini muncul sebagai WebUIContactVideoCallActivatedEventArgs.

public ref class ContactVideoCallActivatedEventArgs sealed : IActivatedEventArgs, IContactVideoCallActivatedEventArgs

/// [Windows.Foundation.Metadata.ContractVersion(Windows.ApplicationModel.Activation.ContactActivatedEventsContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ContactVideoCallActivatedEventArgs final : IActivatedEventArgs, IContactVideoCallActivatedEventArgs

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.ApplicationModel.Activation.ContactActivatedEventsContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ContactVideoCallActivatedEventArgs : IActivatedEventArgs, IContactVideoCallActivatedEventArgs

Public NotInheritable Class ContactVideoCallActivatedEventArgs
Implements IActivatedEventArgs, IContactVideoCallActivatedEventArgs

Warisan: Object Platform::Object IInspectable ContactVideoCallActivatedEventArgs

Atribut: ContractVersionAttribute MarshalingBehaviorAttribute

Penerapan: IActivatedEventArgs IContactActivatedEventArgs IContactVideoCallActivatedEventArgs

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

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

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

void App::OnActivated(Windows::ApplicationModel::Activation::IActivatedEventArgs const& args)
{
    if (args.Kind() == Windows::ApplicationModel::Activation::ActivationKind::Contact)
    {
        auto contactArgs{ args.as<Windows::ApplicationModel::Activation::IContactActivatedEventArgs>() };
        if (contactArgs.Verb() == Windows::ApplicationModel::Contacts::ContactLaunchActionVerbs::VideoCall())
        {
            auto videoCallArgs{ contactArgs.as<Windows::ApplicationModel::Activation::ContactVideoCallActivatedEventArgs>() };

            // Get contact display info.
            auto contactName{ videoCallArgs.Contact().DisplayName() };
            auto contactThumbnail{ videoCallArgs.Contact().Thumbnail() };

            if (videoCallArgs.ServiceId() == L"skype.com")
            {
                auto userId = videoCallArgs.ServiceUserId();
                //add messaging 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 == "skype.com")
            {
                auto userId = videoCallArgs->ServiceUserId;
                //add video calling logic for Skype Ids
            }
        }
    }
}

Keterangan

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.

Properti

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

Bagikan melalui