Membuat dan menggunakan layanan aplikasi
Penting
Daftar kode dalam topik ini hanya C#. Untuk aplikasi sampel layanan aplikasi di C++/WinRT serta C#, lihat Aplikasi sampel app service.
Layanan aplikasi adalah aplikasi UWP yang menyediakan layanan ke aplikasi UWP lainnya. Mereka dianalogikan dengan layanan web, pada perangkat. Layanan aplikasi berjalan sebagai tugas latar belakang di aplikasi host dan dapat menyediakan layanannya ke aplikasi lain. Misalnya, layanan aplikasi mungkin menyediakan layanan pemindai kode batang yang dapat digunakan aplikasi lain. Atau mungkin rangkaian aplikasi Enterprise memiliki layanan aplikasi pemeriksaan ejaan umum yang tersedia untuk aplikasi lain di suite. Layanan aplikasi memungkinkan Anda membuat layanan tanpa UI yang dapat dipanggil aplikasi di perangkat yang sama, dan dimulai dengan Windows 10, versi 1607, di perangkat jarak jauh.
Mulai dari Windows 10, versi 1607, Anda dapat membuat layanan aplikasi yang berjalan dalam proses yang sama dengan aplikasi host. Artikel ini berfokus pada pembuatan dan penggunaan layanan aplikasi yang berjalan dalam proses latar belakang terpisah. Lihat Mengonversi layanan aplikasi untuk berjalan dalam proses yang sama dengan aplikasi hostnya untuk detail selengkapnya tentang menjalankan layanan aplikasi dalam proses yang sama dengan penyedia.
Membuat proyek penyedia layanan aplikasi baru
Dalam cara ini, kita akan membuat semuanya dalam satu solusi untuk kesederhanaan.
Di Visual Studio 2015 atau yang lebih baru, buat proyek aplikasi UWP baru dan beri nama AppServiceProvider.
- Pilih File > Proyek Baru > ...
- Dalam kotak dialog Buat proyek baru , pilih Aplikasi Kosong (Universal Windows) C#. Ini akan menjadi aplikasi yang membuat layanan aplikasi tersedia untuk aplikasi UWP lainnya.
- Klik Berikutnya, lalu beri nama proyek AppServiceProvider, pilih lokasi untuk proyek tersebut, lalu klik Buat.
Ketika diminta untuk memilih versi Target dan Minimum untuk proyek, pilih setidaknya 10.0.14393. Jika Anda ingin menggunakan atribut SupportsMultipleInstances baru, Anda harus menggunakan Visual Studio 2017 atau Visual Studio 2019, dan menargetkan 10.0.15063 (Windows 10 Creators Update) atau yang lebih baru.
Menambahkan ekstensi layanan aplikasi ke Package.appxmanifest
Dalam proyek AppServiceProvider , buka file Package.appxmanifest di editor teks:
- Klik kanan di Penjelajah Solusi.
- Pilih Buka Dengan.
- Pilih Editor XML (Teks).
Tambahkan ekstensi berikut AppService di <Application> dalam elemen . Contoh ini mengiklankan com.microsoft.inventory layanan dan adalah apa yang mengidentifikasi aplikasi ini sebagai penyedia layanan aplikasi. Layanan aktual akan diimplementasikan sebagai tugas latar belakang. Proyek layanan aplikasi mengekspos layanan ke aplikasi lain. Sebaiknya gunakan gaya nama domain terbalik untuk nama layanan.
Perhatikan bahwa awalan xmlns:uap4 namespace dan uap4:SupportsMultipleInstances atribut hanya valid jika Anda menargetkan Windows SDK versi 10.0.15063 atau yang lebih baru. Anda dapat menghapusnya dengan aman jika Anda menargetkan versi SDK yang lebih lama.
Catatan
Untuk aplikasi sampel layanan aplikasi di C++/WinRT serta C#, lihat Aplikasi sampel app service.
<Package
...
xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
xmlns:uap4="http://schemas.microsoft.com/appx/manifest/uap/windows10/4"
...
<Applications>
<Application Id="AppServiceProvider.App"
Executable="$targetnametoken$.exe"
EntryPoint="AppServiceProvider.App">
...
<Extensions>
<uap:Extension Category="windows.appService" EntryPoint="MyAppService.Inventory">
<uap3:AppService Name="com.microsoft.inventory" uap4:SupportsMultipleInstances="true"/>
</uap:Extension>
</Extensions>
...
</Application>
</Applications>
Atribut Category mengidentifikasi aplikasi ini sebagai penyedia layanan aplikasi.
Atribut EntryPoint mengidentifikasi kelas yang memenuhi syarat namespace layanan yang mengimplementasikan layanan, yang akan kami terapkan berikutnya.
Atribut SupportsMultipleInstances menunjukkan bahwa setiap kali layanan aplikasi disebut bahwa layanan aplikasi harus berjalan dalam proses baru. Ini tidak diperlukan tetapi tersedia untuk Anda jika Anda memerlukan fungsionalitas tersebut dan menargetkan 10.0.15063 SDK (Windows 10 Creators Update) atau yang lebih baru. Ini juga harus diawali dengan uap4 namespace layanan.
Membuat layanan aplikasi
Layanan aplikasi dapat diimplementasikan sebagai tugas latar belakang. Ini memungkinkan aplikasi latar depan untuk memanggil layanan aplikasi di aplikasi lain. Untuk membuat layanan aplikasi sebagai tugas latar belakang, tambahkan proyek komponen Windows Runtime baru ke solusi (File > Tambahkan > Proyek Baru) bernama MyAppService. Dalam kotak dialog Tambahkan Proyek Baru, pilih Komponen Runtime Visual C# > Windows Terinstal > (Windows Universal).
Dalam proyek AppServiceProvider, tambahkan referensi proyek-ke-proyek ke proyek MyAppService baru (di Penjelajah Solusi, klik kanan pada proyek >AppServiceProviderTambahkan>SolusiProyek>Referensi>, pilih MyAppService>OK). Langkah ini sangat penting karena jika Anda tidak menambahkan referensi, layanan aplikasi tidak akan terhubung saat runtime.
Dalam proyek MyAppService , tambahkan pernyataan penggunaan berikut ke bagian atas Class1.cs:
using Windows.ApplicationModel.AppService; using Windows.ApplicationModel.Background; using Windows.Foundation.Collections;Ganti nama Class1.cs menjadi Inventory.cs, dan ganti kode stub untuk Class1 dengan kelas tugas latar belakang baru bernama Inventory:
public sealed class Inventory : IBackgroundTask { private BackgroundTaskDeferral backgroundTaskDeferral; private AppServiceConnection appServiceconnection; private String[] inventoryItems = new string[] { "Robot vacuum", "Chair" }; private double[] inventoryPrices = new double[] { 129.99, 88.99 }; public void Run(IBackgroundTaskInstance taskInstance) { // Get a deferral so that the service isn't terminated. this.backgroundTaskDeferral = taskInstance.GetDeferral(); // Associate a cancellation handler with the background task. taskInstance.Canceled += OnTaskCanceled; // Retrieve the app service connection and set up a listener for incoming app service requests. var details = taskInstance.TriggerDetails as AppServiceTriggerDetails; appServiceconnection = details.AppServiceConnection; appServiceconnection.RequestReceived += OnRequestReceived; } private async void OnRequestReceived(AppServiceConnection sender, AppServiceRequestReceivedEventArgs args) { // This function is called when the app service receives a request. } private void OnTaskCanceled(IBackgroundTaskInstance sender, BackgroundTaskCancellationReason reason) { if (this.backgroundTaskDeferral != null) { // Complete the service deferral. this.backgroundTaskDeferral.Complete(); } } }Kelas ini adalah tempat layanan aplikasi akan melakukan pekerjaannya.
Jalankan dipanggil ketika tugas latar belakang dibuat. Karena tugas latar belakang dihentikan setelah Eksekusi selesai, kode mengeluarkan penahanan sehingga tugas latar belakang akan tetap berfungsi untuk melayani permintaan. Layanan aplikasi yang diimplementasikan sebagai tugas latar belakang akan tetap hidup selama sekitar 30 detik setelah menerima panggilan kecuali dipanggil lagi dalam jendela waktu tersebut atau penahanan diambil. Jika layanan aplikasi diimplementasikan dalam proses yang sama dengan pemanggil, masa pakai layanan aplikasi terkait dengan masa pakai pemanggil.
Masa pakai layanan aplikasi tergantung pada pemanggil:
- Jika pemanggil berada di latar depan, masa pakai layanan aplikasi sama dengan pemanggil.
- Jika penelepon berada di latar belakang, layanan aplikasi akan berjalan 30 detik. Mengeluarkan deferral memberikan tambahan satu kali 5 detik.
OnTaskCanceled dipanggil ketika tugas dibatalkan. Tugas dibatalkan ketika aplikasi klien membuang AppServiceConnection, aplikasi klien ditangguhkan, OS dimatikan atau tidur, atau OS kehabisan sumber daya untuk menjalankan tugas.
Menulis kode untuk layanan aplikasi
OnRequestReceived adalah tempat kode untuk layanan aplikasi pergi. Ganti stub OnRequestReceived di Inventory.csMyAppService dengan kode dari contoh ini. Kode ini mendapatkan indeks untuk item inventori dan meneruskannya, bersama dengan string perintah, ke layanan untuk mengambil nama dan harga item inventori yang ditentukan. Untuk proyek Anda sendiri, tambahkan kode penanganan kesalahan.
private async void OnRequestReceived(AppServiceConnection sender, AppServiceRequestReceivedEventArgs args)
{
// Get a deferral because we use an awaitable API below to respond to the message
// and we don't want this call to get canceled while we are waiting.
var messageDeferral = args.GetDeferral();
ValueSet message = args.Request.Message;
ValueSet returnData = new ValueSet();
string command = message["Command"] as string;
int? inventoryIndex = message["ID"] as int?;
if (inventoryIndex.HasValue &&
inventoryIndex.Value >= 0 &&
inventoryIndex.Value < inventoryItems.GetLength(0))
{
switch (command)
{
case "Price":
{
returnData.Add("Result", inventoryPrices[inventoryIndex.Value]);
returnData.Add("Status", "OK");
break;
}
case "Item":
{
returnData.Add("Result", inventoryItems[inventoryIndex.Value]);
returnData.Add("Status", "OK");
break;
}
default:
{
returnData.Add("Status", "Fail: unknown command");
break;
}
}
}
else
{
returnData.Add("Status", "Fail: Index out of range");
}
try
{
// Return the data to the caller.
await args.Request.SendResponseAsync(returnData);
}
catch (Exception e)
{
// Your exception handling code here.
}
finally
{
// Complete the deferral so that the platform knows that we're done responding to the app service call.
// Note for error handling: this must be called even if SendResponseAsync() throws an exception.
messageDeferral.Complete();
}
}
Perhatikan bahwa OnRequestReceived adalah asinkron karena kami melakukan panggilan metode yang dapat ditunggu ke SendResponseAsync dalam contoh ini.
Penangguhan diambil sehingga layanan dapat menggunakan metode asinkron di handler OnRequestReceived . Ini memastikan bahwa panggilan ke OnRequestReceived tidak selesai sampai selesai memproses pesan. SendResponseAsync mengirimkan hasilnya ke pemanggil. SendResponseAsync tidak menandakan penyelesaian panggilan. Ini adalah penyelesaian deferral yang memberi sinyal ke SendMessageAsync bahwa OnRequestReceived telah selesai. Panggilan ke SendResponseAsync dibungkus dalam blok try/finally karena Anda harus menyelesaikan deferral meskipun SendResponseAsync melempar pengecualian.
Layanan aplikasi menggunakan objek ValueSet untuk bertukar informasi. Ukuran data yang mungkin Anda lewati hanya dibatasi oleh sumber daya sistem. Tidak ada kunci yang telah ditentukan sebelumnya untuk Anda gunakan di ValueSet Anda. Anda harus menentukan nilai kunci mana yang akan Anda gunakan untuk menentukan protokol untuk layanan aplikasi Anda. Pemanggil harus ditulis dengan ingat protokol itu. Dalam contoh ini, kami telah memilih kunci bernama Command yang memiliki nilai yang menunjukkan apakah kami ingin layanan aplikasi memberikan nama item inventori atau harganya. Indeks nama inventori disimpan di bawah ID kunci. Nilai yang dikembalikan disimpan di bawah Result kunci.
Enum AppServiceClosedStatus dikembalikan ke pemanggil untuk menunjukkan apakah panggilan ke layanan aplikasi berhasil atau gagal. Contoh bagaimana panggilan ke layanan aplikasi dapat gagal adalah jika OS membatalkan titik akhir layanan karena sumber dayanya telah terlampaui. Anda dapat mengembalikan informasi kesalahan tambahan melalui ValueSet. Dalam contoh ini, kami menggunakan kunci bernama Status untuk mengembalikan informasi kesalahan yang lebih rinci ke pemanggil.
Panggilan ke SendResponseAsync mengembalikan ValueSet ke pemanggil.
Menyebarkan aplikasi layanan dan mendapatkan nama keluarga paket
Penyedia layanan aplikasi harus disebarkan sebelum Anda dapat memanggilnya dari klien. Anda dapat menyebarkannya dengan memilih Build > Deploy Solution di Visual Studio.
Anda juga akan memerlukan nama keluarga paket penyedia layanan aplikasi untuk memanggilnya. Anda bisa mendapatkannya dengan membuka file Package.appxmanifest proyek AppServiceProvider dalam tampilan perancang (klik dua kali di Penjelajah Solusi). Pilih tab Kemasan , salin nilai di samping Nama keluarga paket, dan tempelkan di suatu tempat seperti Notepad untuk saat ini.
Menulis klien untuk memanggil layanan aplikasi
Tambahkan proyek aplikasi Windows Universal kosong baru ke solusi dengan File > Tambahkan > Proyek Baru. Dalam kotak dialog Tambahkan Proyek Baru, pilih Aplikasi Kosong Visual C# > Terinstal > (Windows Universal) dan beri nama ClientApp.
Dalam proyek ClientApp , tambahkan pernyataan penggunaan berikut ke bagian atas MainPage.xaml.cs:
using Windows.ApplicationModel.AppService;Tambahkan kotak teks yang disebut kotak teks dan tombol ke MainPage.xaml.
Tambahkan handler klik tombol untuk tombol yang disebut button_Click, dan tambahkan asinkron kata kunci ke tanda tangan handler tombol.
Ganti stub dari handler klik tombol Anda dengan kode berikut. Pastikan untuk menyertakan
inventoryServicedeklarasi bidang.private AppServiceConnection inventoryService; private async void button_Click(object sender, RoutedEventArgs e) { // Add the connection. if (this.inventoryService == null) { this.inventoryService = new AppServiceConnection(); // Here, we use the app service name defined in the app service // provider's Package.appxmanifest file in the <Extension> section. this.inventoryService.AppServiceName = "com.microsoft.inventory"; // Use Windows.ApplicationModel.Package.Current.Id.FamilyName // within the app service provider to get this value. this.inventoryService.PackageFamilyName = "Replace with the package family name"; var status = await this.inventoryService.OpenAsync(); if (status != AppServiceConnectionStatus.Success) { textBox.Text= "Failed to connect"; this.inventoryService = null; return; } } // Call the service. int idx = int.Parse(textBox.Text); var message = new ValueSet(); message.Add("Command", "Item"); message.Add("ID", idx); AppServiceResponse response = await this.inventoryService.SendMessageAsync(message); string result = ""; if (response.Status == AppServiceResponseStatus.Success) { // Get the data that the service sent to us. if (response.Message["Status"] as string == "OK") { result = response.Message["Result"] as string; } } message.Clear(); message.Add("Command", "Price"); message.Add("ID", idx); response = await this.inventoryService.SendMessageAsync(message); if (response.Status == AppServiceResponseStatus.Success) { // Get the data that the service sent to us. if (response.Message["Status"] as string == "OK") { result += " : Price = " + response.Message["Result"] as string; } } textBox.Text = result; }Ganti nama keluarga paket sejalan
this.inventoryService.PackageFamilyName = "Replace with the package family name";dengan nama keluarga paket proyek AppServiceProvider yang Anda peroleh di atas di Sebarkan aplikasi layanan dan dapatkan nama keluarga paket.Catatan
Pastikan untuk menempelkan string literal, daripada memasukkannya ke dalam variabel. Ini tidak akan berfungsi jika Anda menggunakan variabel.
Kode pertama-tama membuat koneksi dengan layanan aplikasi. Koneksi akan tetap terbuka sampai Anda membuang
this.inventoryService. Nama layanan aplikasi harus cocok denganAppServiceatribut elemenNameyang Anda tambahkan ke file Package.appxmanifest proyek AppServiceProvider. Dalam contoh ini, yaitu<uap3:AppService Name="com.microsoft.inventory"/>.ValueSet bernama
messagedibuat untuk menentukan perintah yang ingin kami kirim ke layanan aplikasi. Contoh layanan aplikasi mengharapkan perintah untuk menunjukkan mana dari dua tindakan yang akan diambil. Kami mendapatkan indeks dari kotak teks di aplikasi klien, lalu memanggil layanan denganItemperintah untuk mendapatkan deskripsi item. Kemudian, kita melakukan panggilan denganPriceperintah untuk mendapatkan harga item. Teks tombol diatur ke hasilnya.Karena AppServiceResponseStatus hanya menunjukkan apakah sistem operasi dapat menghubungkan panggilan ke layanan aplikasi, kami memeriksa
Statuskunci di ValueSet yang kami terima dari layanan aplikasi untuk memastikan bahwa sistem operasi dapat memenuhi permintaan.Atur proyek ClientApp menjadi proyek startup (klik kanan di Set Penjelajah> Solusisebagai Proyek StartUp) dan jalankan solusinya. Masukkan angka 1 ke dalam kotak teks dan klik tombol . Anda harus mendapatkan "Kursi : Harga = 88,99" kembali dari layanan.
Jika panggilan layanan aplikasi gagal, periksa hal berikut di proyek ClientApp :
- Verifikasi bahwa nama keluarga paket yang ditetapkan ke koneksi layanan inventori cocok dengan nama keluarga paket aplikasi AppServiceProvider . Lihat baris di button_Click dengan
this.inventoryService.PackageFamilyName = "...";. - Di button_Click, verifikasi bahwa nama layanan aplikasi yang ditetapkan ke koneksi layanan inventori cocok dengan nama layanan aplikasi di file Package.appxmanifestAppServiceProvider. Lihat:
this.inventoryService.AppServiceName = "com.microsoft.inventory";. - Pastikan bahwa aplikasi AppServiceProvider telah disebarkan. (Di Penjelajah Solusi, klik kanan solusi dan pilih Sebarkan Solusi).
Men-debug layanan aplikasi
- Pastikan bahwa solusi disebarkan sebelum penelusuran kesalahan karena aplikasi penyedia layanan aplikasi harus disebarkan sebelum layanan dapat dipanggil. (Di Visual Studio, bangun > solusi penyebaran).
- Di Penjelajah Solusi, klik kanan proyek AppServiceProvider dan pilih Properti. Dari tab Debug , ubah tindakan Mulai menjadi Jangan luncurkan, tetapi debug kode saya saat dimulai. (Catatan, jika Anda menggunakan C++ untuk mengimplementasikan penyedia layanan aplikasi Anda, dari tab Debugging , Anda akan mengubah Luncurkan Aplikasi menjadi Tidak).
- Dalam proyek MyAppService , dalam file Inventory.cs , atur titik henti di OnRequestReceived.
- Atur proyek AppServiceProvider menjadi proyek startup dan tekan F5.
- Mulai ClientApp dari menu Mulai (bukan dari Visual Studio).
- Masukkan angka 1 ke dalam kotak teks dan tekan tombol . Debugger akan berhenti dalam panggilan layanan aplikasi pada titik henti di layanan aplikasi Anda.
Men-debug klien
- Ikuti instruksi di langkah sebelumnya untuk men-debug klien yang memanggil layanan aplikasi.
- Luncurkan ClientApp dari menu Mulai.
- Lampirkan debugger ke proses ClientApp.exe (bukan proses ApplicationFrameHost.exe ). (Di Visual Studio, pilih Lampirkan Debug > ke Proses....)
- Dalam proyek ClientApp , atur titik henti di button_Click.
- Titik henti di klien dan layanan aplikasi sekarang akan terpukul ketika Anda memasukkan nomor 1 ke dalam kotak teks ClientApp dan klik tombol .
Pemecahan masalah layanan aplikasi umum
Jika Anda menemukan status AppUnavailable setelah mencoba menyambungkan ke layanan aplikasi, periksa hal berikut:
- Pastikan proyek penyedia layanan aplikasi dan proyek layanan aplikasi disebarkan. Keduanya perlu disebarkan sebelum menjalankan klien karena jika tidak, klien tidak akan memiliki apa pun untuk disambungkan. Anda dapat menyebarkan dari Visual Studio dengan menggunakan Build>Deploy Solution.
- Di Penjelajah Solusi, pastikan bahwa proyek penyedia layanan aplikasi Anda memiliki referensi proyek-ke-proyek ke proyek yang mengimplementasikan layanan aplikasi.
- Verifikasi bahwa
<Extensions>entri, dan elemen turunannya, telah ditambahkan ke file Package.appxmanifest milik proyek penyedia layanan aplikasi seperti yang ditentukan di atas dalam Menambahkan ekstensi layanan aplikasi ke Package.appxmanifest. - Pastikan string AppServiceConnection.AppServiceName di klien Anda yang memanggil penyedia layanan aplikasi cocok
<uap3:AppService Name="..." />dengan yang ditentukan dalam file Package.appxmanifest proyek penyedia layanan aplikasi. - Pastikan bahwa AppServiceConnection.PackageFamilyName cocok dengan nama keluarga paket komponen penyedia layanan aplikasi seperti yang ditentukan di atas dalam Menambahkan ekstensi layanan aplikasi ke Package.appxmanifest
- Untuk layanan aplikasi out-of-proc seperti yang ada dalam contoh ini, validasi bahwa yang
EntryPointditentukan dalam<uap:Extension ...>elemen file Package.appxmanifest proyek penyedia layanan aplikasi Anda cocok dengan namespace layanan dan nama kelas kelas kelas publik yang mengimplementasikan IBackgroundTask dalam proyek layanan aplikasi Anda.
Memecahkan masalah penelusuran kesalahan
Jika debugger tidak berhenti di titik henti di penyedia layanan aplikasi atau proyek layanan aplikasi Anda, periksa hal berikut:
- Pastikan proyek penyedia layanan aplikasi dan proyek layanan aplikasi disebarkan. Keduanya perlu disebarkan sebelum menjalankan klien. Anda dapat menyebarkannya dari Visual Studio dengan menggunakan Build>Deploy Solution.
- Pastikan bahwa proyek yang ingin Anda debug ditetapkan sebagai proyek startup dan bahwa properti debugging untuk proyek tersebut diatur untuk tidak menjalankan proyek saat F5 ditekan. Klik kanan proyek, lalu klik Properti, lalu Debug (atau Debugging di C++). Di C#, ubah tindakan Mulai menjadi Jangan luncurkan, tetapi debug kode saya saat dimulai. Di C++, atur Luncurkan Aplikasi ke Tidak.
Keterangan
Contoh ini menyediakan pengenalan untuk membuat layanan aplikasi yang berjalan sebagai tugas latar belakang dan memanggilnya dari aplikasi lain. Hal-hal utama yang perlu diperhatikan adalah:
- Buat tugas latar belakang untuk menghosting layanan aplikasi.
windows.appServiceTambahkan ekstensi ke file Package.appxmanifest penyedia layanan aplikasi.- Dapatkan nama keluarga paket penyedia layanan aplikasi sehingga kami dapat terhubung ke dalamnya dari aplikasi klien.
- Tambahkan referensi proyek-ke-proyek dari proyek penyedia layanan aplikasi ke proyek layanan aplikasi.
- Gunakan Windows.ApplicationModel.AppService.AppServiceConnection untuk memanggil layanan.
Kode lengkap untuk MyAppService
using System;
using Windows.ApplicationModel.AppService;
using Windows.ApplicationModel.Background;
using Windows.Foundation.Collections;
namespace MyAppService
{
public sealed class Inventory : IBackgroundTask
{
private BackgroundTaskDeferral backgroundTaskDeferral;
private AppServiceConnection appServiceconnection;
private String[] inventoryItems = new string[] { "Robot vacuum", "Chair" };
private double[] inventoryPrices = new double[] { 129.99, 88.99 };
public void Run(IBackgroundTaskInstance taskInstance)
{
// Get a deferral so that the service isn't terminated.
this.backgroundTaskDeferral = taskInstance.GetDeferral();
// Associate a cancellation handler with the background task.
taskInstance.Canceled += OnTaskCanceled;
// Retrieve the app service connection and set up a listener for incoming app service requests.
var details = taskInstance.TriggerDetails as AppServiceTriggerDetails;
appServiceconnection = details.AppServiceConnection;
appServiceconnection.RequestReceived += OnRequestReceived;
}
private async void OnRequestReceived(AppServiceConnection sender, AppServiceRequestReceivedEventArgs args)
{
// Get a deferral because we use an awaitable API below to respond to the message
// and we don't want this call to get canceled while we are waiting.
var messageDeferral = args.GetDeferral();
ValueSet message = args.Request.Message;
ValueSet returnData = new ValueSet();
string command = message["Command"] as string;
int? inventoryIndex = message["ID"] as int?;
if (inventoryIndex.HasValue &&
inventoryIndex.Value >= 0 &&
inventoryIndex.Value < inventoryItems.GetLength(0))
{
switch (command)
{
case "Price":
{
returnData.Add("Result", inventoryPrices[inventoryIndex.Value]);
returnData.Add("Status", "OK");
break;
}
case "Item":
{
returnData.Add("Result", inventoryItems[inventoryIndex.Value]);
returnData.Add("Status", "OK");
break;
}
default:
{
returnData.Add("Status", "Fail: unknown command");
break;
}
}
}
else
{
returnData.Add("Status", "Fail: Index out of range");
}
// Return the data to the caller.
await args.Request.SendResponseAsync(returnData);
// Complete the deferral so that the platform knows that we're done responding to the app service call.
// Note for error handling: this must be called even if SendResponseAsync() throws an exception.
messageDeferral.Complete();
}
private void OnTaskCanceled(IBackgroundTaskInstance sender, BackgroundTaskCancellationReason reason)
{
if (this.backgroundTaskDeferral != null)
{
// Complete the service deferral.
this.backgroundTaskDeferral.Complete();
}
}
}
}
Topik terkait
Saran dan Komentar
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: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk