CurrentAppSimulator Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Define métodos y propiedades usados para crear instancias de un objeto que puede usar para obtener información de licencia simulada durante las pruebas.
Note
La clase CurrentAppSimulator y los demás tipos del Windows. ApplicationModel.Store espacio de nombres ya no se actualizan con nuevas características. Si el proyecto tiene como destino Windows 10 Anniversary Edition (10.0; Compilación 14393) o una versión posterior en Visual Studio (es decir, tiene como destino Windows 10, versión 1607 o posterior), se recomienda usar el espacio de nombres Windows.Services.Store en su lugar. Para obtener más información, consulte Pruebas y compras desde la aplicación. La clase CurrentAppSimulator no se admite en Windows aplicaciones de escritorio que usan el Desktop Bridge o en aplicaciones o juegos que usan un espacio aislado de desarrollo en Partner Center (por ejemplo, este es el caso de cualquier juego que se integre con Xbox Live). Estos productos deben usar el espacio de nombres Windows.Services.Store para implementar las compras y pruebas dentro de la aplicación.
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
- Herencia
- Atributos
Requisitos de Windows
| Requisitos | Description |
|---|---|
| Familia de dispositivos |
Windows 10 (se introdujo en la versión 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)
|
Comentarios
Hasta que la aplicación se haya enumerado en el Microsoft Store, el objeto CurrentApp no funcionará en la aplicación. Usa CurrentAppSimulator para probar los productos de licencia y dentro de la aplicación mientras desarrollas la aplicación. Después de probar la aplicación y antes de enviarlo al Microsoft Store, debe reemplazar las instancias de CurrentAppSimulator por CurrentApp. La aplicación producirá un error en la certificación si usa CurrentAppSimulator.
Cuando se usa CurrentAppSimulator, el estado de licencia inicial de la aplicación se describe en un archivo denominado WindowsStoreProxy.xml. Los métodos CurrentAppSimulator que modifican el estado de la licencia, por ejemplo, comprando una licencia o controlando una compra desde la aplicación, solo actualizan el estado de licencia del objeto en memoria. No se cambia el contenido de WindowsStoreProxy.xml. Cuando la aplicación se inicia de nuevo, el estado de la licencia vuelve a lo que se describe en WindowsStoreProxy.xml.
Para obtener más información sobre el archivo WindowsStoreProxy.xml, vea Uso del archivo WindowsStoreProxy.xml con CurrentAppSimulator.
Propiedades
| Nombre | Description |
|---|---|
| AppId |
Obtiene un identificador de aplicación simulado. Dado que CurrentAppSimulator está pensado solo para las pruebas durante el desarrollo de aplicaciones, currentAppSimulator.AppId devuelto solo contendrá 0' s. Una vez que la aplicación aparezca en la Tienda Windows, CurrentApp.AppId obtendrá el GUID generado durante el incorporación de la aplicación y se usará para enumerar la aplicación en el catálogo de Windows Store. Note Las actualizaciones de la aplicación o los cambios en la descripción de la aplicación no darán lugar a un cambio en CurrentApp.AppId. |
| LicenseInformation |
Obtiene los metadatos de licencia simulados para la aplicación actual, tal como se proporciona en la simulación. |
| LinkUri |
Obtiene el identificador uniforme de recursos (URI) simulado que representa una página de lista de Microsoft Store para la aplicación actual. |
Métodos
| Nombre | Description |
|---|---|
| GetAppPurchaseCampaignIdAsync() |
Recupera el identificador de campaña de promoción de la aplicación actual. |
| GetAppReceiptAsync() |
Crea la operación asincrónica que el usuario puede usar para simular la solicitud de todos los recibos de esta aplicación y las compras de productos desde la aplicación. Para obtener ejemplos de cómo se puede usar la información de recibo, consulte Uso de recibos para comprobar las compras de productos. |
| GetProductReceiptAsync(String) |
Crea la operación asincrónica que el usuario puede usar para simular la solicitud del recibo del identificador de producto especificado. Para obtener ejemplos de cómo se puede usar la información de recibo, consulte Uso de recibos para comprobar las compras de productos. |
| GetUnfulfilledConsumablesAsync() |
Devuelve una lista de productos consumibles comprados en la aplicación que no se han cumplido localmente. |
| LoadListingInformationAsync() |
Carga la información de la descripción de la aplicación simulada de forma asincrónica. El objeto ListingInformation devuelto contiene información de descripción (por ejemplo, nombre, precio, clasificación por edad) específica del mercado en el que reside actualmente el usuario. Además, también se proporciona información de descripción de los productos disponibles a través de productos en la aplicación. Note Con fines de simulación, este método usa el elemento del archivo WindowsStoreProxy.xml como origen de datos para los miembros del objeto devuelto. Para obtener más información, consulta los ejemplos de código en CurrentAppSimulator. |
| LoadListingInformationByKeywordsAsync(IIterable<String>) |
Carga la información de la descripción de la aplicación simulada de forma asincrónica, devolviendo productos desde la aplicación en la colección ProductListings que coinciden con todas las palabras clave proporcionadas. |
| LoadListingInformationByProductIdsAsync(IIterable<String>) |
Carga la información de la descripción de la aplicación simulada de forma asincrónica, devolviendo los productos disponibles en la aplicación en la colección ProductListings que coinciden con cualquiera de los identificadores de productos especificados. |
| ReloadSimulatorAsync(StorageFile) |
Vuelve a cargar el simulador mediante un storageFile que contiene el archivo WindowsStoreProxy.xml . Si no llama a este método para cargar su propio archivo, el simulador creará o cargará (pero no sobrescribirá) un archivo WindowsStoreProxy.xml que contenga un conjunto de valores predeterminados. |
| ReportConsumableFulfillmentAsync(String, Guid) |
Simula notificar al Microsoft Store que se cumple la compra de un complemento consumible (también denominado producto desde la aplicación o IAP) y que el usuario tiene derecho a acceder al contenido. |
| RequestAppPurchaseAsync(Boolean) |
Importante La funcionalidad de compra desde la aplicación no se admite en aplicaciones con privilegios elevados. Crea la operación asincrónica que simula una solicitud de usuario para comprar una licencia completa para la aplicación actual. |
| RequestProductPurchaseAsync(String, Boolean) |
Importante La funcionalidad de compra desde la aplicación no se admite en aplicaciones con privilegios elevados. Note [RequestProductPurchaseAsync(String, Boolean) puede modificarse o no estar disponible para las versiones después de Windows 8.1. En su lugar, use RequestProductPurchaseAsync(String). Crea la operación asincrónica que muestra la interfaz de usuario que se usa para simular la compra de un complemento (también denominado producto desde la aplicación o IAP) desde el Microsoft Store. |
| RequestProductPurchaseAsync(String, String, ProductPurchaseDisplayProperties) |
Importante La funcionalidad de compra desde la aplicación no se admite en aplicaciones con privilegios elevados. Crea la operación asincrónica que muestra la interfaz de usuario que se usa para simular la compra de un complemento (también denominado producto desde la aplicación o IAP) desde el Microsoft Store. Esta sobrecarga incluye parámetros que puedes usar para mostrar los detalles de una oferta específica dentro de un catálogo grande de compras desde la aplicación representadas por una sola entrada de producto en la Tienda. |
| RequestProductPurchaseAsync(String) |
Importante La funcionalidad de compra desde la aplicación no se admite en aplicaciones con privilegios elevados. Crea la operación asincrónica que muestra la interfaz de usuario que se usa para simular la compra de un complemento (también denominado producto desde la aplicación o IAP) desde el Microsoft Store. |