Share via


CurrentAppSimulator Kelas

Definisi

Menentukan metode dan properti yang digunakan untuk membuat instans objek yang dapat Anda gunakan untuk mendapatkan info lisensi yang disimulasikan selama pengujian.

Catatan

Kelas CurrentAppSimulator dan jenis lainnya di namespace Windows.ApplicationModel.Store tidak lagi diperbarui dengan fitur baru. Jika proyek Anda menargetkan Windows 10 Anniversary Edition (10.0; Build 14393) atau rilis yang lebih baru di Visual Studio (yaitu, Anda menargetkan Windows 10, versi 1607, atau yang lebih baru), kami sarankan Anda menggunakan namespace Windows.Services.Store sebagai gantinya. Untuk informasi selengkapnya, lihat Pembelian dan uji coba dalam aplikasi. Kelas CurrentAppSimulator tidak didukung di aplikasi desktop Windows yang menggunakan Desktop Bridge atau di aplikasi atau game yang menggunakan kotak pasir pengembangan di Pusat Mitra (misalnya, ini adalah kasus untuk setiap game yang terintegrasi dengan Xbox Live). Produk-produk ini harus menggunakan namespace Windows.Services.Store untuk mengimplementasikan pembelian dan uji coba dalam aplikasi.

public ref class CurrentAppSimulator abstract sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class CurrentAppSimulator final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public static class CurrentAppSimulator
Public Class CurrentAppSimulator
Warisan
Object Platform::Object IInspectable CurrentAppSimulator
Atribut

Persyaratan Windows

Rangkaian perangkat
Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Keterangan

Hingga aplikasi tercantum di Microsoft Store, objek CurrentApp tidak akan berfungsi di aplikasi. Gunakan CurrentAppSimulator untuk menguji lisensi aplikasi dan produk dalam aplikasi saat Anda mengembangkan aplikasi. Setelah menguji aplikasi, dan sebelum mengirimkannya ke Microsoft Store, Anda harus mengganti instans CurrentAppSimulator dengan CurrentApp. Aplikasi Anda akan gagal sertifikasi jika menggunakan CurrentAppSimulator.

Saat CurrentAppSimulator digunakan, status lisensi awal aplikasi dijelaskan dalam file bernama WindowsStoreProxy.xml. Metode CurrentAppSimulator yang mengubah status lisensi, misalnya dengan membeli lisensi atau menangani pembelian dalam aplikasi, hanya memperbarui status lisensi objek dalam memori. Isi WindowsStoreProxy.xml tidak diubah. Saat aplikasi dimulai lagi, status lisensi kembali ke apa yang dijelaskan dalam WindowsStoreProxy.xml.

Untuk informasi selengkapnya tentang file WindowsStoreProxy.xml, lihat Menggunakan file WindowsStoreProxy.xml dengan CurrentAppSimulator.

Properti

AppId

Mendapatkan ID aplikasi yang disimulasikan. Karena CurrentAppSimulator hanya ditujukan untuk pengujian selama pengembangan aplikasi, CurrentAppSimulator.AppId yang dikembalikan hanya akan berisi 0.

Setelah aplikasi Anda tercantum di Windows Store, CurrentApp.AppId akan mendapatkan GUID yang dihasilkan selama on-boarding aplikasi dan digunakan untuk mencantumkan aplikasi Anda dalam katalog Windows Store.

Catatan

Pembaruan aplikasi atau perubahan pada deskripsi aplikasi tidak akan mengakibatkan perubahan pada CurrentApp.AppId.

LicenseInformation

Mendapatkan metadata lisensi yang disimulasikan untuk aplikasi saat ini sebagaimana disediakan oleh simulasi.

LinkUri

Mendapatkan Simulasi Pengidentifikasi Sumber Daya Seragam (URI) yang mewakili halaman daftar Microsoft Store untuk aplikasi saat ini.

Metode

GetAppPurchaseCampaignIdAsync()

Mengambil ID kampanye promosi untuk aplikasi saat ini.

GetAppReceiptAsync()

Membuat operasi asinkron yang dapat digunakan pengguna untuk mensimulasikan permintaan semua tanda terima untuk aplikasi ini dan pembelian produk dalam aplikasi apa pun. Untuk contoh bagaimana informasi tanda terima dapat digunakan, lihat Menggunakan tanda terima untuk memverifikasi pembelian produk.

GetProductReceiptAsync(String)

Membuat operasi asinkron yang dapat digunakan pengguna untuk mensimulasikan permintaan tanda terima untuk ID produk yang ditentukan. Untuk contoh bagaimana informasi tanda terima dapat digunakan, lihat Menggunakan tanda terima untuk memverifikasi pembelian produk.

GetUnfulfilledConsumablesAsync()

Mengembalikan daftar produk dalam aplikasi habis pakai yang dibeli yang belum terpenuhi secara lokal.

LoadListingInformationAsync()

Memuat informasi daftar aplikasi yang disimulasikan secara asinkron.

Objek ListingInformation yang dikembalikan berisi informasi daftar (misalnya, nama, harga, peringkat usia) khusus untuk pasar tempat pengguna saat ini berada. Selain itu, daftar informasi untuk produk yang tersedia melalui produk dalam aplikasi juga disediakan.

Catatan

Untuk tujuan simulasi, metode ini menggunakan elemen dalam file WindowsStoreProxy.xml sebagai sumber data untuk anggota objek yang dikembalikan. Untuk informasi selengkapnya, lihat contoh kode di CurrentAppSimulator.

LoadListingInformationByKeywordsAsync(IIterable<String>)

Memuat informasi daftar aplikasi yang disimulasikan secara asinkron, mengembalikan produk dalam aplikasi dalam koleksi ProductListings yang cocok dengan semua kata kunci yang disediakan.

LoadListingInformationByProductIdsAsync(IIterable<String>)

Memuat informasi daftar aplikasi yang disimulasikan secara asinkron, mengembalikan produk dalam aplikasi yang tersedia di koleksi ProductListings yang cocok dengan SALAH SATU ID produk yang diberikan.

ReloadSimulatorAsync(StorageFile)

Memuat ulang simulator menggunakan StorageFile yang berisi file WindowsStoreProxy.xml .

Jika Anda tidak memanggil metode ini untuk memuat file Anda sendiri, simulator akan membuat/memuat (tetapi tidak menimpa) file WindowsStoreProxy.xml yang berisi sekumpulan nilai default.

ReportConsumableFulfillmentAsync(String, Guid)

Mensimulasikan memberi tahu Microsoft Store bahwa pembelian add-on yang dapat dikonsumsi (juga disebut produk dalam aplikasi atau IAP) terpenuhi dan bahwa pengguna memiliki hak untuk mengakses konten.

RequestAppPurchaseAsync(Boolean)

Membuat operasi asinkron yang mensimulasikan permintaan pengguna untuk membeli lisensi penuh untuk aplikasi saat ini.

RequestProductPurchaseAsync(String)

Membuat operasi asinkron yang menampilkan UI yang digunakan untuk mensimulasikan pembelian add-on (juga disebut produk dalam aplikasi atau IAP) dari Microsoft Store.

RequestProductPurchaseAsync(String, Boolean)

Catatan

[RequestProductPurchaseAsync(String, Boolean) dapat diubah atau tidak tersedia untuk rilis setelah Windows 8.1. Sebagai gantinya, gunakan RequestProductPurchaseAsync(String).

Membuat operasi asinkron yang menampilkan UI yang digunakan untuk mensimulasikan pembelian add-on (juga disebut produk dalam aplikasi atau IAP) dari Microsoft Store.

RequestProductPurchaseAsync(String, String, ProductPurchaseDisplayProperties)

Membuat operasi asinkron yang menampilkan UI yang digunakan untuk mensimulasikan pembelian add-on (juga disebut produk dalam aplikasi atau IAP) dari Microsoft Store. Kelebihan beban ini mencakup parameter yang dapat Anda gunakan untuk menampilkan detail untuk penawaran tertentu dalam katalog besar pembelian dalam aplikasi yang diwakili oleh satu entri produk di Toko.

Berlaku untuk

Lihat juga