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 puedes 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 demás 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, el destino es 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, consulta Pruebas y compras desde la aplicación. La clase CurrentApp no se admite en las aplicaciones de escritorio de Windows que usan el Puente de dispositivo de escritorio o en aplicaciones o juegos que usan un espacio aislado de desarrollo en el Centro de partners (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 desde la aplicación.
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 CurrentAppPublic Class CurrentApp- Herencia
- Atributos
Requisitos de Windows
| 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 a partir de un archivo XML). Consulte CurrentAppSimulator.
Historial de versiones
| Versión de Windows | Versión del SDK | Valor agregado |
|---|---|---|
| 1511 | 10586 | GetCustomerCollectionsIdAsync |
| 1511 | 10586 | GetCustomerPurchaseIdAsync |
Propiedades
| AppId |
Obtiene el GUID generado por la Tienda Windows cuando la aplicación se ha certificado para enumerar en la Tienda Windows. Nota Una vez que la aplicación se encuentra 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
| 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 dentro de la aplicación. Para obtener ejemplos de cómo se puede usar la información de recibos, 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 pertenecen al usuario actual. |
| GetCustomerPurchaseIdAsync(String, String) |
Recupera una clave de identificador de Microsoft Store que se puede usar para conceder derechos para 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 recibos, consulte Uso de recibos para comprobar las compras de productos. |
| GetUnfulfilledConsumablesAsync() |
Devuelve una lista de productos consumibles comprados desde 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 edades) 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 descripción de la aplicación de forma asincrónica, devolviendo características y productos de la colección ProductListings que coinciden con todas las palabras clave proporcionadas. |
| LoadListingInformationByProductIdsAsync(IIterable<String>) |
Carga la información de descripción de la aplicación de forma asincrónica, devolviendo características y productos de la colección ProductListings que coinciden con cualquiera de los identificadores de productos especificados. |
| 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 suministro mediante este método. |
| RequestAppPurchaseAsync(Boolean) |
Solicita la compra de una licencia de aplicación completa. |
| 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, Boolean) |
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) |
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. |