CurrentApp Clase

Definición

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 CurrentApp no se admite en las aplicaciones de escritorio de Windows que usan el de Puente de escritorio de o en aplicaciones o juegos que usan un espacio aislado de desarrollo en 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 CurrentApp
Public Class CurrentApp
Herencia
Object Platform::Object IInspectable CurrentApp
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 que coinciden con todas las palabras clave proporcionadas.

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 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 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.

Se aplica a

Consulte también