WebUIContactCallActivatedEventArgs Kelas

Referensi

Definisi

Ruang nama:: Windows.UI.WebUI

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 memanggil kontak.

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

Warisan: Object Platform::Object IInspectable WebUIContactCallActivatedEventArgs

Atribut: ContractVersionAttribute MarshalingBehaviorAttribute

Penerapan: IActivatedEventArgs IContactActivatedEventArgs IContactCallActivatedEventArgs IActivatedEventArgsDeferral

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

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 memanggil kontak mereka dari pengalaman Kartu Kontak atau Windows Search. Dengan menerapkan kontrak aktivasi panggilan kontak, Windows dapat meluncurkan aplikasi Anda untuk melakukan panggilan bagi pengguna.

Untuk menerima aktivasi panggilan, 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 "panggilan." Anda kemudian dapat menentukan elemen "ServiceId" untuk menentukan jenis panggilan yang Anda dukung. Misalnya, jika aplikasi Anda menangani panggilan PSTN standar, Anda dapat menentukan "ServiceId" dari "telepon." Jika aplikasi Anda menangani panggilan melalui layanan berbasis web, seperti Skype, Anda dapat menentukan nama domain layanan tersebut, misalnya "skype.com."

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

Catatan

Untuk memungkinkan pengguna mengatur aplikasi Anda sebagai aplikasi panggilan default mereka untuk nomor PSTN, aplikasi Anda juga harus mendukung skema URI "tel".

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="call" DesiredView="useLess">
        <m2:ServiceId>telephone</m2:ServiceId>
        <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 kontak. Saat aplikasi diaktifkan, Anda dapat menggunakan informasi peristiwa untuk mengidentifikasi aktivasi panggilan dan mengekstrak parameter yang membantu Anda menyelesaikan panggilan untuk pengguna.

Berikut adalah contoh kode yang Anda butuhkan untuk menangani aktivasi panggilan kontak untuk nomor PSTN dan Id Skype:

Properti

ActivatedOperation	Mendapatkan operasi yang diaktifkan aplikasi.
Contact	Mendapatkan kontak untuk panggilan.
Kind	Mendapatkan jenis aktivasi.
PreviousExecutionState	Mendapatkan status eksekusi aplikasi sebelum diaktifkan.
ServiceId	Mendapatkan pengidentifikasi layanan yang digunakan untuk panggilan.
ServiceUserId	Mendapatkan pengidentifikasi pengguna dari layanan yang digunakan untuk panggilan.
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