PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV 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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Renvoie la liste :
  • des produits de l'application achetés par l'utilisateur et non consommés.
  • Versions 23 et supérieures
    des abonnements actifs de l'utilisateur.
    Nouveauté 23
    des abonnements actifs de l'utilisateur.
    des abonnements actifs de l'utilisateur.
Versions 23 et supérieures
iPhone/iPad Cette fonction est désormais disponible dans les applications iPhone/iPad.
Nouveauté 23
iPhone/iPad Cette fonction est désormais disponible dans les applications iPhone/iPad.
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)
PROCEDURE 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 SEPAREE 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
PROCEDURE 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 (avec ou sans guillemets)
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.
Versions 23 et supérieures
Dans le cas d'un abonnement : date de souscription de l'abonnement.
Nouveauté 23
Dans le cas d'un abonnement : date de souscription de l'abonnement.
Dans le cas d'un abonnement : date de souscription de l'abonnement.
Versions 23 et supérieures
inAppDateFinAbonnement
Nouveauté 23
inAppDateFinAbonnement
inAppDateFinAbonnement
Date 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é.
Versions 23 et supérieures
iPhone/iPad Cet identifiant a la même valeur que celle obtenue avec la constante inAppNuméroCommande.
Nouveauté 23
iPhone/iPad Cet identifiant a la même valeur que celle obtenue avec la constante inAppNuméroCommande.
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.
Versions 23 et supérieures
inAppRenouvellementAuto
Nouveauté 23
inAppRenouvellementAuto
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.
  • La fonction inAppListeAchat est disponible uniquement sur les appareils disposant d’une version d’Android supérieure ou égale à la version 2.2 (api level 8).
    Si la fonction est utilisée avec une version antérieure du système, une erreur fatale sera déclenchée.
    Pour connaître la version du système Android sur laquelle s’exécute l’application, utilisez la fonction SysVersionAndroid.
  • 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.
Versions 23 et supérieures

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.
Nouveauté 23

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.

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.
Composantes
Android wd230android.jar
Version minimum requise
  • Version 19
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire