ContactCallActivatedEventArgs Kelas
Definisi
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.
Menyediakan data saat aplikasi diaktifkan untuk memanggil kontak.
Javascript Jenis ini muncul sebagai WebUIContactCallActivatedEventArgs.
public ref class ContactCallActivatedEventArgs sealed : IActivatedEventArgs, IContactCallActivatedEventArgs
/// [Windows.Foundation.Metadata.ContractVersion(Windows.ApplicationModel.Activation.ContactActivatedEventsContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ContactCallActivatedEventArgs final : IActivatedEventArgs, IContactCallActivatedEventArgs
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.ApplicationModel.Activation.ContactActivatedEventsContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ContactCallActivatedEventArgs : IActivatedEventArgs, IContactCallActivatedEventArgs
Public NotInheritable Class ContactCallActivatedEventArgs
Implements IActivatedEventArgs, IContactCallActivatedEventArgs
- Warisan
- 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
Berikut adalah contoh kode yang Anda butuhkan untuk menangani aktivasi panggilan kontak untuk nomor PSTN dan 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.Call)
{
IContactCallActivatedEventArgs callArgs = contactArgs as IContactCallActivatedEventArgs;
//get contact display info
var contactName = callArgs.Contact.DisplayName;
var contactThumbnail = callArgs.Contact.Thumbnail;
if (callArgs.ServiceId == "telephone")
{
var phoneNumber = callArgs.ServiceUserId;
//add calling logic for PSTN numbers
}
else if (callArgs.ServiceId == "skype.com")
{
var userId = callArgs.ServiceUserId;
//add 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::Call())
{
auto callArgs{ contactArgs.as<Windows::ApplicationModel::Activation::ContactCallActivatedEventArgs>() };
// Get contact display info.
auto contactName{ callArgs.Contact().DisplayName() };
auto contactThumbnail{ callArgs.Contact().Thumbnail() };
if (callArgs.ServiceId() == L"telephone")
{
auto phoneNumber{ callArgs.ServiceUserId() };
// Add calling logic for PSTN numbers.
}
else if (callArgs.ServiceId() == L"skype.com")
{
auto userId{ callArgs.ServiceUserId() };
// Add calling 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::Call)
{
auto callArgs = dynamic_cast<ContactCallActivatedEventArgs^>(contactArgs);
//get contact display info
auto contactName = callArgs->Contact->DisplayName;
auto contactThumbnail = callArgs->Contact->Thumbnail;
if (callArgs->ServiceId == "telephone")
{
auto phoneNumber = callArgs->ServiceUserId;
//add calling logic for PSTN numbers
}
else if (callArgs->ServiceId == "skype.com")
{
auto userId = callArgs->ServiceUserId;
//add calling logic for Skype Ids
}
}
}
}
Keterangan
Windows 8.1 memungkinkan pengguna untuk memanggil kontak mereka dari pengalaman Kartu Kontak atau Pencarian Windows. Dengan menerapkan kontrak aktivasi panggilan kontak, Windows dapat meluncurkan aplikasi Anda untuk melakukan panggilan untuk 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 satu dari mereka 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.
Untuk informasi tentang cara menangani aktivasi aplikasi melalui tindakan kontak, lihat Mulai Cepat: Menangani tindakan kontak .
Properti
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
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk