DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions spécifiques Mobile / Fonctions Achats In-App
  • Cas particuliers
  • Gestion des abonnements
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Renvoie la liste :
  • des produits de l'application achetés par l'utilisateur et non consommés.
  • des abonnements actifs de l'utilisateur.
iPhone/iPad Cette fonction est désormais disponible dans les applications iPhone/iPad.
Exemple
// Récupération de la liste des achats de l'utilisateur
inAppListeAchat(ListeAchat, inAppIdentifiantAchat)
PROCÉDURE ListeAchat(bSuccès est un booléen, sListeAchat est une chaîne)
SI PAS bSuccès ALORS
ToastAffiche(ErreurInfo())
SINON
// Parcours les achats effectués
POUR TOUTE CHAÎNE sInfoAchat DE sListeAchat SÉPARÉE PAR RC
// Récupère l'identifiant du produit
sIDProduit est une chaîne = ExtraitChaîne(sInfoAchat, 1, TAB)
// Récupère l'identifiant de l'achat
sIDAchat est une chaîne = ExtraitChaîne(sInfoAchat, 2, TAB)
// Consomme le produit si nécessaire
SI sIDProduit = "ID_PRODUIT" ALORS
inAppConsommeProduit(sIDProduit, ConsommationProduit)
FIN
FIN
FIN
FIN
PROCÉDURE ConsommationProduit(nSuccès est un booléen)
SI PAS bSuccès ALORS
ToastAffiche(ErreurInfo())
SINON
// Consommation du produit dans l'application
...
FIN
FIN
Syntaxe
<Résultat> = inAppListeAchat(<Procédure> [, <Type information>])
<Résultat> : Booléen
  • Vrai si la demande de récupération de la liste des achats a été effectuée,
  • Faux dans le cas contraire. Pour plus de détails sur l'erreur, utilisez la fonction ErreurInfo.
<Procédure> : Chaîne de caractères
Nom de la procédure WLangage (également nommée "callback") exécutée lors de la réception de la liste des achats effectués. Pour plus de détails sur cette procédure, consultez Paramètres de la procédure utilisée par la fonction inAppListeAchat.
<Type information> : Constante optionnelle de type Entier
Informations supplémentaire à retourner pour chaque achat listé (en plus de l'identifiant du produit) :
inAppDateAchatDate d'achat au format AAAAMMJJ.
Dans le cas d'un abonnement : date de souscription de l'abonnement.
inAppDateFinAbonnementDate de fin d'abonnement au format AAAAMMJJ.
Android Information non disponible. Correspond toujours à chaîne vide ("").
Si l'utilisateur a annulé son abonnement, cet abonnement sera listé par la fonction inAppListeAchat jusqu'à la prochaine date de facturation et l'utilisateur perdra l'accès à l'abonnement à ce moment-là (voir Gestion des abonnements).
inAppIdentifiantAchatIdentifiant de l'achat.
Android Cet identifiant est utilisé dans la fonction inAppConsommeProduit pour effectuer la consommation d'un produit acheté.
iPhone/iPad Cet identifiant a la même valeur que celle obtenue avec la constante inAppNuméroCommande.
inAppNuméroCommandeNuméro de la commande correspondant à l'achat.
inAppRenouvellementAuto
  • 1 si l'abonnement sera automatiquement renouvelé à la prochaine date de facturation.
  • 0 si l'utilisateur a annulé son abonnement ou si l'achat ne correspond pas à un abonnement.
iPhone/iPad Information non disponible. Correspond toujours à 0.
Remarques

Cas particuliers

  • Android Lorsqu'un produit acheté est consommé (fonction inAppConsommeProduit), il n'apparaît plus dans la liste renvoyée par la fonction inAppListeAchat et peut à nouveau être acheté par l'utilisateur (fonction inAppAchèteProduit).
  • La fonction inAppListeAchat sera sans effet si elle est exécutée depuis le simulateur ou l'émulateur.
iPhone/iPad Un produit consommable est toujours consommé directement à l'achat et n'apparaîtra donc jamais dans le résultat de la fonction inAppListeAchat.

Gestion des abonnements

Android En Android :
  • Si un abonnement est listé par la fonction inAppListeAchat, l'utilisateur doit avoir accès au contenu de l'abonnement.
  • Si l'utilisateur a annulé son abonnement, cet abonnement sera listé par la fonction inAppListeAchat jusqu'à la prochaine date de facturation et l'utilisateur perdra l'accès à l'abonnement à ce moment-là. Il est possible de proposer à l'utilisateur de renouveler son abonnement depuis l'application (fonction inAppAchèteProduit).
iPhone/iPad En iOS :
  • L'abonnement est valide entre la date d'achat et la date de fin d'abonnement.
  • Un abonnement expiré peut être renvoyé par la fonction inAppListeAchat. Il appartient à l'application de décider le contenu qui reste accessible à la fin d'un abonnement.
Composante : wd290android.aar
Version minimum requise
  • Version 19
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 22/06/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale