En esta página

Demostración de compras dentro de la aplicación: clases base

Las siguientes clases base forman parte de la demostración de compras dentro de la aplicación:

Clases

ClaseDescripción
InAppProductUn producto registrado en la tienda.
InAppStorePunto de entrada principal para gestionar las compras dentro de la aplicación.
InAppTransactionContiene información sobre una transacción en la tienda de aplicaciones externa.
InAppPurchaseBackendSe comunica con la tienda externa.

InAppProduct

InAppProduct encapsula un producto de la tienda externa una vez que se ha registrado en InAppStore y se ha confirmado su existencia. Cuenta con un identificador que coincide con el del producto en la tienda externa, un precio que se obtiene de la tienda externa y un tipo de producto.

El tipo de producto puede ser « Consumable » o « Unlockable ». Los productos consumibles se pueden comprar tantas veces como se desee, siempre y cuando la aplicación finalice explícitamente cada transacción. Los productos desbloqueables solo se pueden comprar una vez.

`InAppProduct` tiene 5 variables de retorno: ` price`, ` title`, ` description `, ` identifier ` y ` productType`. Todas devuelven un ` QString `, excepto `productType`.

ProductType es un tipo enumerado y devuelve 0 si es Consumible y 1 si es Desbloqueable.

enum ProductType
{
   Consumable,
   Unlockable
};

Echa un vistazo a las clases derivadas « AndroidInAppProduct » para Android y « IosInAppProduct » para iOS.

InAppStore

El punto de entrada principal para gestionar las compras dentro de la aplicación. Es la clase base de « AndroidInAppProduct » y « IosInAppProduct ».

InAppStore se utiliza para gestionar las compras dentro de la aplicación de forma multiplataforma. Dependiendo del compilador, InAppStore comprueba qué plataforma está disponible utilizando Macros.

void InAppStore::setupBackend()
{
   #ifdef Q_OS_ANDROID
   d->backend = new AndroidInAppPurchaseBackend;
   #endif

   #ifdef Q_OS_IOS
   d->backend = new IosInAppPurchaseBackend;
   #endif

   d->backend->setStore(this);

   ...

Inicialización de la tienda

Al acceder a la página de la tienda en la demostración, InAppStore conecta todas las señales a las ranuras correspondientes en la función setupBackend(). A continuación, utiliza la función registerProduct() para registrar el ID y el tipo de cada producto registrado en la tienda externa en la propiedad registeredProducts de QHash.

El registro de un producto es asíncrono y, en algún momento, generará la señal productRegistered() cuando se encuentre en la tienda externa.

void InAppStore::registerProduct(InAppProduct *product)
{
   d->registeredProducts[product->identifier()] = product;
   emit productRegistered(product);
}

Finalización de una compra

Una vez que los artículos se han registrado correctamente en la tienda, el usuario puede comprarlos pulsando sobre uno de los productos en la página de la tienda de la aplicación. QML llamará a la función product.purchase() en AndroidInAppProduct o en IosInAppProduct, lo que abrirá el flujo de compra de la tienda externa.

Cuando se haya completado una compra, independientemente de si ha tenido éxito o no, se enviará la señal transactionReady a InAppProductQmlType para notificar a QML que debe iniciar la finalización de la transacción.

Restauración de compras

En la demostración, las compras desbloqueables se guardarán en el almacenamiento de la aplicación. Al borrar el almacenamiento, el usuario perderá la compra desbloqueable y no podrá volver a adquirirla, ya que, según la tienda externa, ya es de su propiedad.

Puedes utilizar el botón « restore purchases » de la página de la tienda de la aplicación para restaurar tus compras desbloqueables. El botón «Restaurar compras» llama a la función `restorePurchases()` y comprueba en la tienda externa las compras que ya posees. Emite la señal `transactionRedy()` para finalizar y restaurar la compra.

InAppStore no tiene clases derivadas.

InAppTransaction

InAppTransaction contiene información sobre una transacción en la tienda de aplicaciones externa y suele obtenerse como resultado de llamar a InAppProduct::purchase(). Cuando el usuario haya completado el proceso de compra (confirmando la compra, por ejemplo, introduciendo su contraseña), la instancia de InAppStore que contiene el producto emitirá una señal InAppStore::transactionReady() con datos sobre la transacción.

La función status() proporciona información sobre si la transacción se ha realizado con éxito o no. Si se ha realizado con éxito, la aplicación debe llevar a cabo la acción adecuada. Una vez realizada la acción necesaria, se debe llamar a finalize(). La función finalize() debe llamarse independientemente del estado de la transacción.

Echa un vistazo a las clases derivadas AndroidInAppTransaction para Android y IosInAppTransaction para iOS.

InAppPurchaseBackend

InAppPurchaseBackend se utiliza para crear clases derivadas de AndroidInAppPurchaseBackend y IosInAppPurchaseBackend.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.