DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • 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. Cette procédure est de la forme :
PROCEDURE <NomProcédure>(<Succès> est un booléen, <ListeAchat> est une chaîne)
où :
  • <Succès> est un booléen :
    • Vrai si la liste des achats effectués par l'utilisateur a pu être récupérée,
    • Faux dans le cas contraire. Pour récupérer le détail de l'erreur, utilisez la fonction ErreurInfo avant tout autre appel à une fonction WLangage (ce qui réinitialiserait l'erreur).
  • <ListeAchat> est une chaîne de caractères contenant les informations sur chacun des achats effectués par l'utilisateur. Les informations retournées pour chaque achat sont de la forme (selon les informations demandées) :
    <Identifiant du produit> + TAB + <Numéro de commande> + TAB + <Date d'achat> +
    TAB + <Identifiant de l'achat> + TAB + <Renouvellement automatique> + TAB +
    <Date de fin d'abonnement>
Si plusieurs achats sont listés, ils sont séparés par des Retours Chariot (RC).
<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 : wd280android.aar
Version minimum requise
  • Version 19
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire