CurrentAppSimulator 類別

定義

命名空間:

Windows.ApplicationModel.Store

定義用來具現化物件的方法和屬性，讓您可用來在測試期間取得模擬授權資訊。

注意

CurrentAppSimulator類別和Windows.ApplicationModel.Store命名空間中的其他類型不再使用新功能進行更新。 如果您專案的目標為 Visual Studio 中的 Windows 10 Anniversary Edition (10.0；組建 14393) 或更新版本 (也就是，您以 Windows 10 版本 1607 或更新版本為目標)，建議您改用 Windows.Services.Store 命名空間。 如需詳細資訊，請參閱 App 內購買和試用版。 例如，在合作夥伴中心 (使用 傳統型橋接器開發沙箱的 Windows傳統型應用程式中，不支援CurrentAppSimulator類別，這是任何與 Xbox Live) 整合的遊戲。 這些產品必須使用 Windows.Services.Store 命名空間來實作 App 內購買和試用版。

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

繼承

Object Platform::Object IInspectable CurrentAppSimulator

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

備註

在 Microsoft Store 中列出應用程式之前， CurrentApp 物件將無法在應用程式中運作。 當您開發應用程式時，請使用 CurrentAppSimulator 來測試應用程式的授權和應用程式內產品。 測試 App 後，在將它提交到 Microsoft Store 之前，您必須將所有 CurrentAppSimulator 取代為 CurrentApp。 如果您的 App 使用 CurrentAppSimulator，將無法通過認證。

使用 CurrentAppSimulator 時，應用程式的初始授權狀態會在名為 WindowsStoreProxy.xml 的檔案中描述。 CurrentAppSimulator 方法可改變授權狀態，例如購買授權或處理應用程式內購買，只會更新記憶體中物件的授權狀態。 不會變更 WindowsStoreProxy.xml 的內容。 當 App 重新啟動時，授權狀態會還原到 WindowsStoreProxy.xml 中所描述的狀態。

如需 WindowsStoreProxy.xml 檔案的詳細資訊，請參閱 搭配 CurrentAppSimulator 使用 WindowsStoreProxy.xml 檔案。

屬性

AppId	取得模擬的應用程式識別碼。 由於 CurrentAppSimulator 僅適用于在應用程式開發期間進行測試，傳回的 CurrentAppSimulator.AppId 只會包含 0 個。 一旦您的應用程式列在 Windows 市集上， CurrentApp.AppId 就會在應用程式上線期間產生 GUID ，並用來列出 Windows 市集目錄中的應用程式。 注意 應用程式更新或應用程式描述的變更將不會產生 CurrentApp.AppId的變更。
LicenseInformation	取得模擬所提供的目前應用程式的模擬授權中繼資料。
LinkUri	取得模擬的統一資源識別元 (URI) ，代表目前應用程式的 Microsoft Store 清單頁面。

方法

GetAppPurchaseCampaignIdAsync()	擷取目前應用程式的促銷行銷活動識別碼。
GetAppReceiptAsync()	建立異步操作，讓使用者可用來模擬要求此應用程式的所有收據，以及任何應用程式內產品購買。 如需如何使用收據資訊的範例，請參閱 使用收據來驗證產品購買。
GetProductReceiptAsync(String)	建立異步操作，讓使用者可用來模擬要求指定產品識別碼的收據。 如需如何使用收據資訊的範例，請參閱 使用收據來驗證產品購買。
GetUnfulfilledConsumablesAsync()	傳回未在本機完成的已購買消費性應用程式內產品清單。
LoadListingInformationAsync()	以非同步方式載入模擬應用程式清單資訊。 傳回的 ListingInformation 物件包含清單資訊 (，例如，名稱、價格、年齡分級，) 使用者目前所在的市場。 此外，也會提供透過應用程式內產品取得的產品清單資訊。 注意 為了模擬目的，此方法會使用 WindowsStoreProxy.xml 檔案中的 元素做為傳回物件成員的資料來源。 如需詳細資訊，請參閱 CurrentAppSimulator中的程式碼範例。
LoadListingInformationByKeywordsAsync(IIterable<String>)	以非同步方式載入模擬應用程式清單資訊，並在 ProductListings 集合中傳回符合所有提供關鍵字的應用程式內產品。
LoadListingInformationByProductIdsAsync(IIterable<String>)	以非同步方式載入模擬應用程式清單資訊，傳回 ProductListings 集合中符合任何指定產品識別碼的應用程式內產品。
ReloadSimulatorAsync(StorageFile)	使用包含WindowsStoreProxy.xml檔案的StorageFile重載模擬器。 如果您未呼叫這個方法來載入自己的檔案，模擬器將會建立/載入 (，但不會覆) 寫包含一組預設值 的WindowsStoreProxy.xml 檔案。
ReportConsumableFulfillmentAsync(String, Guid)	模擬通知 Microsoft Store，購買消費性附加元件 (也稱為應用程式內產品或 IAP) ，且使用者有權存取內容。
RequestAppPurchaseAsync(Boolean)	建立模擬使用者要求以購買目前應用程式完整授權的非同步作業。
RequestProductPurchaseAsync(String)	建立異步操作，以顯示用來模擬從 Microsoft Store 購買附加元件 (也稱為應用程式內產品或 IAP) 的 UI。
RequestProductPurchaseAsync(String, Boolean)	注意 [RequestProductPurchaseAsync (String，布林值) 可能會在Windows 8.1之後變更或無法使用版本。 請改用 RequestProductPurchaseAsync (String) 。 建立異步操作，以顯示用來模擬從 Microsoft Store 購買附加元件 (也稱為應用程式內產品或 IAP) 的 UI。
RequestProductPurchaseAsync(String, String, ProductPurchaseDisplayProperties)	建立異步操作，以顯示用來模擬從 Microsoft Store 購買附加元件 (也稱為應用程式內產品或 IAP) 的 UI。 此多載包含參數，可用來在市集內單一產品專案所代表的大型應用程式內購買目錄中，顯示特定供應專案的詳細資料。

另請參閱

• 市集範例 ()
• 試用應用程式和應用程式內購買範例 ()