Demostración de compras dentro de la aplicación
Una aplicación móvil completa que muestra cómo realizar compras de productos dentro de la aplicación.
Nota: El módulo Qt Purchasing fue uno de los módulos eliminados en Qt 6.0, y el código se incluye ahora en este ejemplo a modo de guía sobre cómo utilizar Qt para integrarse con las tiendas de aplicaciones más habituales.
¿En qué consiste esta demostración?

Esta demostración es una aplicación de juego para móviles basada en el clásico juego de adivinar palabras «El ahorcado», en el que se pueden comprar vocales a través de la tienda interna de la demostración. En el juego se te mostrará una fila de guiones, que representan las letras de la palabra que debes adivinar. Al adivinar una letra correcta que aparezca en la palabra dada, dicha letra se colocará en el guion o guiones correspondientes de la palabra. Si adivinas todas las letras de la palabra o adivinas la palabra completa correctamente en cualquier momento, el juego termina y has ganado. Si la respuesta es incorrecta, se dibuja un elemento de una figura de palitos colgada. Una vez completada la figura, te quedas sin intentos y pierdes.
La demo muestra cómo es posible ofrecer productos dentro de una aplicación Qt, para las plataformas Android e iOS. Para probar la funcionalidad de compra dentro de la aplicación en la demo, primero debes registrar la aplicación y sus productos en la tienda externa. Para obtener una introducción sobre cómo hacerlo, consulta las guías de Google Play y App Store, respectivamente.
Tiendas de aplicaciones de terceros
Los productos dentro de la aplicación deben registrarse en las tiendas de destino antes de que puedan consultarse o comprarse en una aplicación. Recomendamos utilizar los mismos identificadores para los productos en cada tienda, ya que esto simplifica el código para consultar y comprar los productos.
- Demostración de compras dentro de la aplicación: Google Play
- Demostración de compras dentro de la aplicación: App Store de iOS
¿Cómo funciona la demostración?
La demostración es una aplicación QML que registra tipos QML para acceder a información sobre productos dentro de la aplicación, así como para solicitar la compra de dichos productos. Estos se registran en la tienda externa correspondiente a la plataforma de destino
Las compras dentro de la aplicación se añaden a la aplicación añadiendo primero un objeto Store. En la demostración, el objeto Store lo crea el componente MainView, que se carga al iniciar la aplicación.
Store {
id: iapStore
}La demostración define un componente para mostrar una tienda en la que se pueden adquirir los productos disponibles dentro de la aplicación. Estos productos deben registrarse primero en el objeto Store que hemos creado anteriormente en MainView. Hay dos productos disponibles; el primero es de tipo consumible.
Product {
id: product100Vowels
store: iapStore
type: Product.Consumable
identifier: "qt.io.demo.hangman.100vowels"
onPurchaseSucceeded: {
console.log(identifier + " purchase successful");
//Add 100 Vowels
applicationData.vowelsAvailable += 100;
transaction.finalize();
pageStack.pop();
}
onPurchaseFailed: {
console.log(identifier + " purchase failed");
console.log("reason: "
+ transaction.failureReason === Transaction.CanceledByUser ? "Canceled" : transaction.errorString);
transaction.finalize();
}
}Este producto consumible proporciona 100 vocales adicionales que se pueden utilizar a la hora de adivinar palabras en el juego. Cuando se compra con éxito, actualizamos el estado de la aplicación para incluir 100 vocales adicionales. A continuación, llamamos a finalize() en el objeto de transacción para confirmar a la tienda de la plataforma que se ha proporcionado el producto consumible.
El segundo producto es de tipo no consumible y desbloqueará vocales de forma permanente en el futuro. Además de actualizar el estado de la aplicación al realizar la compra, debemos asegurarnos de proporcionar una forma de restaurar esta compra en otros dispositivos utilizados por el usuario final. En este caso, creamos un controlador de señal para onPurchaseRestored.
Product {
id: productUnlockVowels
type: Product.Unlockable
store: iapStore
identifier: "qt.io.demo.hangman.unlockvowels"
onPurchaseSucceeded: {
console.log(identifier + " purchase successful");
applicationData.vowelsUnlocked = true;
transaction.finalize();
pageStack.pop();
}
onPurchaseFailed: {
console.log(identifier + " purchase failed");
console.log("reason: "
+ transaction.failureReason === Transaction.CanceledByUser ? "Canceled" : transaction.errorString);
transaction.finalize();
}
onPurchaseRestored: {
console.log(identifier + " purchase restored");
applicationData.vowelsUnlocked = true;
console.log("timestamp: " + transaction.timestamp);
transaction.finalize();
pageStack.pop();
}
}
Además de registrar los productos, la demostración también proporciona una interfaz para comprar realmente el producto registrado. La demostración define un componente personalizado llamado « StoreItem » para mostrar y gestionar la interacción de compra.
Product {
id: productUnlockVowels
type: Product.Unlockable
store: iapStore
identifier: "qt.io.demo.hangman.unlockvowels"
onPurchaseSucceeded: {
console.log(identifier + " purchase successful");
applicationData.vowelsUnlocked = true;
transaction.finalize();
pageStack.pop();
}
onPurchaseFailed: {
console.log(identifier + " purchase failed");
console.log("reason: "
+ transaction.failureReason === Transaction.CanceledByUser ? "Canceled" : transaction.errorString);
transaction.finalize();
}
onPurchaseRestored: {
console.log(identifier + " purchase restored");
applicationData.vowelsUnlocked = true;
console.log("timestamp: " + transaction.timestamp);
transaction.finalize();
pageStack.pop();
}
}El componente StoreItem mostrará los datos del producto que se obtienen de la tienda de la plataforma y llamará al método purchase() del producto cuando el usuario haga clic en él.
Text {
id: titleText
text: product.title
font.bold: true
anchors.right: priceText.left
anchors.rightMargin: topLevel.globalMargin
anchors.top: parent.top
anchors.topMargin: topLevel.globalMargin
anchors.left: parent.left
anchors.leftMargin: topLevel.globalMargin
}
Text {
id: descriptionText
text: product.description
anchors.right: priceText.left
anchors.rightMargin: topLevel.globalMargin
anchors.left: parent.left
anchors.leftMargin: topLevel.globalMargin
anchors.top: titleText.bottom
anchors.topMargin: topLevel.globalMargin / 2
wrapMode: Text.WordWrap
}
Text {
id: priceText
text: product.price
anchors.right: parent.right
anchors.rightMargin: topLevel.globalMargin
anchors.verticalCenter: parent.verticalCenter
}
MouseArea {
anchors.fill: parent
onClicked: {
pendingRect.visible = true;
spinBox.visible = true;
statusText.text = "Purchasing...";
storeItem.state = "PURCHASING";
product.purchase();
}
onPressed: {
storeItem.state = "PRESSED";
}
onReleased: {
storeItem.state = "NORMAL";
}
}Android e iOS utilizan las clases base. A partir de las clases base hay clases derivadas para Android e iOS:
- Demostración de compras dentro de la aplicación: clases base
- Demostración de compras dentro de la aplicación: clases de Android
- Demostración de compras dentro de la aplicación: clases de iOS
Compras dentro de la aplicación
Las compras dentro de la aplicación son una forma de monetizar una aplicación. Estas compras se realizan desde dentro de la aplicación y pueden incluir desde desbloquear contenido hasta adquirir artículos virtuales. La demostración utiliza las API del sistema para las compras dentro de la aplicación, lo que significa que el proceso de compra resulta más familiar para el usuario, y que la información ya almacenada por la plataforma (como los datos de la tarjeta de crédito) puede utilizarse para simplificar el proceso de compra.
Licencias y atribuciones
En cuanto a la implementación de la demostración en Android, consulta «Licencias de tiempo de ejecución de Android GNU C++» para obtener más información.
© 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.