iap_activate(product_index);
| Argument | La description |
|---|---|
| product_index | L'indice de la ds_list qui contient les achats disponibles. |
Retours: N / A
Cette fonction permet d'effectuer des achats dans l'application et prépare GameMaker Studio 2 en fournissant le produit ds_list qui détient une série de ds_maps avec les informations sur chaque achat disponible. Cela signifie que vous devrez indiquer à GameMaker Studio 2 toutes les options d'achat disponibles en les réglant individuellement ds_maps (un pour chaque achat disponible), qui sont ensuite stockés dans un ds_list, qui est alors "activé" avec cette fonction.
Les cartes d'achat individuelles qui doivent être stockées dans le ds_list devrait avoir le format suivant de paires clé-valeur:
- " id " - L'ID de produit pour l'achat, par exemple: "LevelPack".
- " title " - Le nom de l'achat, par exemple: "Level Pack 1".
- " description " - La description de l'achat, par exemple: "Level Pack 1 for Catch The Clown".
- " prix " - Le prix de l'achat, par exemple: " $1.00".
- " type " - Windows 8 et Windows Phone seulement! Le type d'achat, qui devrait être soit "Consommable" ou "Durable". "Durable" est la valeur par défaut (non consommable).
Il convient de noter que les seules clés essentielles pour toute configuration de magasin cible (par ID de produit) sont les "id", à l'exception des cibles Windows 8 et Windows Phone, auquel cas vous avez également besoin de la clé "type". Notez que pour ces plateformes cibles, si vous voulez que le magasin rapporte des données significatives (correctes) en mode bac à sable, alors le "titre", la "description", etc... sont nécessaires.
Activer les achats déclenchera également un événement IAP, ce qui crée un événement spécial iap_data ds_map du type d'événement iap_ev_product. Cette ds_map aura la clé supplémentaire suivante:
- " index " - L'ID de produit pour le produit activé.
Si vous activez plusieurs produits, chaque produit déclenche son propre événement IAP du type iap_ev_product où vous pouvez ensuite obtenir l'ID du produit. Il convient de noter que le Google Play Store (pour Android ) ne peut traiter que les détails des produits 20 à la fois, ce qui peut entraîner des temps de chargement assez longs pour les applications comportant un nombre important de produits.
NOTE: Toutes les paires clé / valeur qui composent une carte d'achat sont des chaînes!
var purchaseList, purchase1;
purchaseList = ds_list_create();
purchase1 = ds_map_create();
ds_map_add(purchase1, "id", "LevelPack");
ds_map_add(purchase1, "title", "ExtraLevels1");
ds_map_add(purchase1, "description", "Level Pack 1 for Catch The
Clown");
ds_map_add(purchase1, "price", "$1.00");
ds_list_add(purchaseList, purchase1);
iap_activate(purchaseList);
ds_map_destroy(purchase1);
ds_list_destroy(purchaseList);
Le code ci-dessus va créer un ds_list et un ds_map, qui est ensuite rempli par les informations pour effectuer un achat. Cette carte est ajoutée à la liste puis activée en tant qu'achat disponible pour le jeu. Finalement, le ds_list et ds_map sont supprimés pour éviter les fuites de mémoire car ils ne sont plus nécessaires.