CurrentApp 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 que puede usar para obtener información de licencia y descripción sobre la aplicación actual y realizar compras de productos desde la aplicación.
Nota
La clase CurrentApp y los otros tipos del espacio de nombres Windows.ApplicationModel.Store 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 compras desde la aplicación y pruebas. La clase
public ref class CurrentApp 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 CurrentApp 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 CurrentApp
Public Class CurrentApp
- 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
Este objeto obtiene sus datos de Microsoft Store, por lo que debes tener una cuenta de desarrollador y la aplicación debe publicarse en Microsoft Store. Antes de enviar a Microsoft Store, puedes probar el código con una versión simulada de esta clase (cuyo estado se inicializa desde un archivo XML). Consulte currentAppSimulator.
Historial de versiones
| Versión de Windows | Versión del SDK | Valor añadido |
|---|---|---|
| 1511 | 10586 | GetCustomerCollectionsIdAsync |
| 1511 | 10586 | GetCustomerPurchaseIdAsync |
Propiedades
| Nombre | Description |
|---|---|
| AppId |
Obtiene el GUID de generado por la Tienda Windows cuando la aplicación se ha certificado para mostrarla en la Tienda Windows. Nota Una vez que la aplicación esté en la Tienda Windows, las actualizaciones futuras 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 de la aplicación actual. |
| LinkUri |
Obtiene el identificador uniforme de recursos (URI) de la página de descripción de la aplicación en el catálogo web de la Tienda Windows. |
Métodos
| Nombre | Description |
|---|---|
| GetAppPurchaseCampaignIdAsync() |
Recupera el identificador de campaña de promoción de la aplicación actual. |
| GetAppReceiptAsync() |
Solicita todos los recibos para la compra de la aplicación y cualquier producto 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. |
| GetCustomerCollectionsIdAsync(String, String) |
Recupera una clave de identificador de Microsoft Store que se puede usar para consultar los derechos del producto o para consumir derechos de producto que son propiedad del usuario actual. |
| GetCustomerPurchaseIdAsync(String, String) |
Recupera una clave de identificador de Microsoft Store que se puede usar para conceder derechos a productos gratuitos en nombre del usuario actual. |
| GetProductReceiptAsync(String) |
Solicita el 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 notificado a Microsoft Store como cumplidos. |
| LoadListingInformationAsync() |
Carga la información de descripción de la aplicación 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 la información de descripción de los productos disponibles en la aplicación. |
| LoadListingInformationByKeywordsAsync(IIterable<String>) |
Carga la información de la descripción de la aplicación de forma asincrónica, devolviendo características y productos en la colección productListings |
| LoadListingInformationByProductIdsAsync(IIterable<String>) |
Carga la información de la descripción de la aplicación de forma asincrónica, devolviendo características y productos en la colección productListings de |
| ReportConsumableFulfillmentAsync(String, Guid) |
Notifica a 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. |
| ReportProductFulfillment(String) |
Notifica a Microsoft Store que la aplicación ha cumplido el producto desde la aplicación. Este producto no se puede volver a comprar hasta que la aplicación haya confirmado el cumplimiento mediante este método. |
| RequestAppPurchaseAsync(Boolean) |
Importante La funcionalidad de compra desde la aplicación no se admite en aplicaciones con privilegios elevados. Solicita la compra de una licencia de aplicación completa. |
| RequestProductPurchaseAsync(String, Boolean) |
Importante La funcionalidad de compra desde la aplicación no se admite en aplicaciones con privilegios elevados. Nota [RequestProductPurchaseAsync(String, Boolean) puede modificarse o no estar disponible para las versiones después de Windows 8.1. En su lugar, use RequestProductPurchaseAsync(String). Solicita la compra de un complemento (también denominado producto desde la aplicación o IAP). Además, al llamar a este método se muestra la interfaz de usuario que se usa para completar la transacción a través de Microsoft Store. |
| RequestProductPurchaseAsync(String, String, ProductPurchaseDisplayProperties) |
Importante La funcionalidad de compra desde la aplicación no se admite en aplicaciones con privilegios elevados. Solicita la compra de un complemento (también denominado producto desde la aplicación o IAP). Además, al llamar a este método se muestra la interfaz de usuario que se usa para completar la transacción a través de 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. Solicita la compra de un complemento (también denominado producto desde la aplicación o IAP). Además, al llamar a este método se muestra la interfaz de usuario que se usa para completar la transacción a través de Microsoft Store. |