Advanced Godot | Creating In-App Purchases

hey guys this is mitch with fine point cgi and  today we're going to talk about doing in-app   purchases inside of godot so we're going to go  through the process of explaining how in-app   purchases operate we're going to go ahead and  download our plugin we are going to go ahead   and set up our scene and set up our project  we are going to then code our signals and our   project itself and then we're going to go ahead  and set up our application out on the google   play store so that we can do internal  application testing and we are going to then   download our app and test  it and verify our results   so that's what i have in store for you guys  today so let's go ahead and get started so the first thing that we need to know is  how the google api works for in-app purchases   now i already kind of built up this little diagram  for you guys but basically the way that it works   is you have an android phone and this little phone  goes out and sends our connection request to the   google cloud api once it's done that then it can  go ahead and query the sku that it's trying to   purchase so think of a sku as just the single item  that you're trying to purchase okay and then what   happens is the google cloud api will respond with  that sku information so think of it kind of like   hey can i get the info on this item google says  hey yeah here's the item here's how much it costs   things like that and then android will say  hey i want to purchase this item when the   when the player says yeah i want to buy this you  go ahead and click on the button to purchase it   it's going to send out a request  to the google cloud api saying hey   i'm going to buy this thing google's going to  send back a purchase acknowledgement saying   yeah they got this they successfully purchased  this item and you'll get this little item token   here and this item token is basically your  item it's literally what makes your item   the item then you're going to take this  item token right and you're going to say hey i want to use this item so i want to go and  consume it and give the player its perks right so   what you do is you just go ahead and send out this  token say yup i want to consume this item and use   it so it goes out to the google cloud api consumes  it and they no longer have access to the item   anymore so that's what we're going to be building  today and uh yeah let's go ahead and build it okay so the first thing that we need to do is we  need to go ahead and download our godot billing   library now one of the coolest things about this  is that it is officially supported by the godot   engine instead of by some other developer or  some other open source project so we're going   to do is we're going to click right here we're  going to go ahead and download this so let's   grab both of these you're going to want the aar  and the gdap so let's pull both of those down   and then let's go ahead and open up godot   all right now let's go ahead and make up a new  project so hit new project and let's just call it   we'll call it the godot iap uh tutorial project  all right let's go ahead and create and edit   that so the first thing we're going to do is  we are going to go ahead and go to project   install android build template and go ahead and  install that so it's going to run through and   uncompress our build sources and then we're going  to right click here and open it in file manager   now from here we're going to go to our  android we're going to go to our plugin   and finally we are going to grab from our  downloads folder the gdap file and the aar file   so we're going to copy both of those and throw  it in our android plugins now if we click on our   godot project here you'll see that there is an  android plugins folder here now you're not going   to see the aar file or the gdap file but trust  me they're there and we'll go ahead and click on   project export we're going to add in android and  then we're going to go ahead and make sure that we   find our custom build and turn it on and now that  we have it on we can come down here to our godot   google play billing we'll go ahead and turn that  on if we hover over it you'll see that it says   plugins godot google play billing so remember that  we're gonna need that for when we start our coding   so let's go ahead and hit close and  then let's click on user interface   here and let's go ahead and hit ctrl s  and save and call this billing tutorial billing tutorial scene and we're going to  right click here add in a child node we're   going to add in a button we're going to need two  buttons for this little uh demo project we're   making so let's go ahead and duplicate this  and pull it down the first one is going to be purchase demo item and what we're going to do is we're going  to have this button go ahead when you hit   it you're going to be purchasing an item and  then we will say use demo item so basically   these two buttons are kind of our  way to be able to purchase the item   and to actually use the set item now from here  what we're going to do is we're going to right   click our control node and we're going  to attach a script and we will call it   billing controller because i do love my  controllers and we're going to click on   our button we're going to name this one use  item and we're going to name this one purchase   item and we're going to go node on button down  double click that and click on our control node   and hit connect and do the same thing with our use  button on button down control node awesome so now   we've got our two major ways of interacting with  this uh api already put together which is awesome   now we need to go ahead and  start coding this little plug-in   now the first thing that we need to do is on  ready we need to go and get our singleton and   what a singleton is is it's the uh plug-in itself  so it's a reference to the plug-in for you to load   and use so we're going to say is if our engine has  our singleton we're going to call the singleton   godot google play billing if you remember and  i believe i spelled a billing wrong because   i'm great at spelling all right the reason why  we're calling it the godot google play billing is   because if we look at our project if you remember  and we go to export we hover over this you'll see   godot google play billing that's how we know what  this singleton is so if we go ahead and hit close   and we from here we need to go ahead and get our  singleton so we'll say var billing is equal to   engine dot get underscore singleton and we  will call it exactly what we called it here   so we're going to go ahead and do that  and now we need to go ahead and connect   our signals now there are a lot of signals  here so bear with me and there's very little   documentation on what each signal does  i mean they all are self-explanatory but   there is very little documentation here  so what we're going to do is we'll say billing dot connect and then  we're going to say connected comma self and then we are going to say comma  quote connected and then we're just going to   copy and paste this a few times i'm not i don't  really know how many we're going to need but i'm   just going to make quite a few of them here we're  going to say disconnected and we're going to put   well let's just do this right  here and then we need to do   connect underscore error and we will say   connect underscore error might as well  name it the same thing purchases updated   and we will call this one also purchases updated uh the plus is probably not useful  i also spelled updated wrong there we are   then we're going to have purchase error and we're just going to grab  purchase error here to fire that off   we're going to have sku underscore details  underscore query underscore completed all right and then we'll go ahead and put  that in and we're going to do the same thing   for basically the same thing so  query and then we will say error   and we're going to pass that in as  well and then we are going to do purchase underscore acknowledged and then we're going to say purchase   acknowledgement error so  if we got an error for that and we will copy and paste that and then we need to consume our purchase right so  when you purchase something and then you need to   be able to consume it and use it and  then tell the server that you used it so   purchase underscore consumed and we will do the same here oops   and then purchase consumption error so  there's actually an error for that as well awesome and that that should be all of  our signals that we need to connect now   you might be asking yourself where in the world  am i getting all that from there's actually a   section here and it's all right here i basically  just followed this all the way down and they give   you a little bit more information but that's  basically what i'm doing is i'm just following   this little section here so the question now is  what do these do well this one here gets fired   when you connect to the library well to  the google api this one gets fired when you disconnect this one it gets fired when you can't  connect this one gets fired when you um get your purchases this one is fired  when you can't get any purchases this one is fired when you get your sku details this one is fired when you can't get your sku details this one is fired when you purchase something fired when you can't purchase anything this one gets fired when you use an item  so you can see here when you consume it   that's when you use it and finally this one  gets fired when you can't consume something   awesome so now that we've got all of  that we need to start our connection so we'll say billing dot start connection we  need a capital c here and what that's going   to do is that's going to fetch out and run  this connected if it is capable of connecting   so now what we need to do is we need to make a  function for our connected state right so func   connected and connected actually does not give  us anything actually i'm coding in c sharp here   there we go connected doesn't take anything in  because the signal doesn't give you anything   but it does give you the capability of  querying the api so the first thing we   need to do is we need to actually query  the item we're trying to purchase right so   the first thing we need to do is  we need to get our singleton here   so instead of me doing it the way i'm doing it  here let's go ahead and pull this out like this out here so that way we have access to  it globally inside of our project here   or inside of our script here so now that we  put this up here what we can do is we can type   billing dot query sku details and we need to  get our sku item details so we can actually   come up with what our sku is going to be called  and let's go ahead and call it quote test   sku and we're going to put a comma here  and we're going to say quote in app and   what that'll do is that'll say hey we're gonna go  and um query for this sku for an in-app purchase   and you need to do this before you make your  purchase now we're only doing a single item   with this tutorial but if you wanted to you if you  wanted to purchase different items or allow them   to purchase different items you're going to need  to pull this out into its own function instead of   doing it on connected and do it on a you know on  demand if that makes sense hey editor mitch here   so the test sku is actually a list of skus that  you want to pull the information for so a lot of   times you would do this before you purchase an  item you're just pulling down how much an item   costs and things like that the data that you get  back is stuff like the name and the description   of the item and usually how much it costs so  a lot of times you would use this to just go   pull um the sku information before you purchase  that item so you have to do this before you   purchase the item if that makes sense also you  have two different types here so you have in-app   and you have subscription so you can  actually use subs if you'd like instead   or subscriptions if you're trying to sell someone  a subscription over top of selling somebody   an in-app purchase so that's just something  to keep in mind all right back to the video   so from here what we need to do is we need  to come down to our button because now we've   queried our skew details the thing that we'd like  to purchase and from this point on we can go ahead   and attempt to purchase it so we're going to come  down here and we're going to say var response is   equal to billing dot purchase and then put in that  test sku now at this point we're getting to the   point where we might want to put this into its  own its own variable but we'll go ahead and and   you know burn that bridge when we get  there so we'll type if response dot status does not equal okay then we're going to need to go ahead  and log an error here so we'll just type print we'll just put error purchasing item so  now that we've got to the point where we have our   querying our sku details and our purchasing  of our item we need to go ahead and   update our purchased items so what  we need to do is we need to say   funk purchases updated first we need to pass in  our purchased items so we're going to say items   and we are going to say for item in items  then i'm going to want to say if not item dot is acknowledged then we're going to want to  go ahead and acknowledge it all right so what does this do so what we're  saying is hey if we want to purchase an item   right we can purchase it here okay but then we  need to acknowledge that that item was purchased   because sometimes if you purchase  an item if you don't acknowledge   and say hey i've received this item the user  might get two or three items instead of one   right because you're saying because the system  doesn't know that it's given it to you that you've   successfully received it you know it sent out  the message saying yeah you've got this item but   we don't know if but the the system that's  keeping track of it the google api doesn't   know that it's receipt or that you've received  this item so you need to acknowledge that   that item has been received so now from here  we're going to say hey if oh back one if item dot size or items dot size is greater than zero  then what we're going to do is we are going to   get our token from that item so that  way we have it in memory so that way   we can say yep this person has this item  if that makes sense so we're going to do   is we're going to create a function up here or  a variable up here and we are going to call it item token all right and we're gonna  say item token is equal to items items dot size minus one dot and we're going to need  to go and fetch the token from that   awesome so what that's going to do is  we're going to say hey get our details   purchase our item acknowledge that our item was  purchased and then return the token okay and   that token is like the unique token that that  item has so think of it kind of it's a it's a   guide or a unique number string basically no  two people in the world will have the same   purchase string or the same token if that  makes sense so when you consume that item   google or the api will release that token so that  it can be used again later so now let's go ahead   and try to purchase or use that item so we're  going to say if our item token is equal to null   then we're going to want to go ahead and log or  i guess print error you need to buy this first and then we're going to say else  let's go ahead and do billing dot consume purchase and you need to  give it the token so item token   awesome so now that we have our basic stuff done what we need to do is we need to do a  little bit of logging in a little bit of prep work   to get this to kind of you know work so let's  say print response dot status and let's say um purchase has been attempted and result there we are and then what we're going to do is we  are going to go here and say print consuming item awesome and then up here we are going to print ac i can't remember how to spell acknowledge acknowledge purchase we'll  just copy and paste that purchases space uh plus item dot purchase underscore  token and now we wanna make sure that   this succeeds so we actually have a purchase  acknowledged so let's go ahead and just grab   that real quick and we'll come down here and we  will do funk purchase acknowledged and we will say   uh it's going to take a token and  we're going to say print purchase was acknowledged exclamation point and then  we're going to plus that token awesome   so now that'll just basically tell us yep that  that worked that was successful and we need to   make sure that we've consumed our item properly  as well so what we need to do is we need to do a purchase consumed here and we need to  allow for that as well so let's do that as well and it will also pass the  token of what item was consumed so whoops i tom was consumed and we are going to  plus our token okay and that's going   to go ahead and just say hey you  know we've successfully done all   of that now we also have a lot of these  errors here that we can also break into and i don't really know if we need all of those  right off hand for the sake of the tutorial but   it's a really good idea to have all of these  tokens here and all of these little connection   errors and details error and purchase error right  here consumption errors so that way you can keep   track of what's going on with your with your  object and with with your project right so you can   keep track of all that but in this specific case  i don't necessarily need it so i think we're okay   now what we're gonna do is we are going to  go ahead and attempt to set up our next step so what i'm going to do is i'm going to go up  here to my google console which is the google play   console and if you've never seen this uh go ahead  and look up a couple of tutorials on it i know   that i'm asking you to go check out other things  but look up other tutorials on this because some   people have covered this way better than i could  ever but what we're going to do is we are going to   go ahead and create an app so we'll click create  an app and we're going to call it in app purchase tutorial and then we are going to say this is   a game this is free and we are going to  say yeah we're good with all those things awesome so now it's going to go ahead and load  and build this app here for us so now that we've   done that this is our dashboard and i'm not  going to go into too in depth i'll put out a   later tutorial that explains this a little bit  more but we do need to go ahead and set up our   app for early internal testing so let's go ahead  and click on view tasks select our testers and i   already have an email list here set up but if not  you can actually just go click this email list and   then just put in your email and then that'll allow  you to be a tester on this uh internal release if   that makes sense so go ahead and hit save changes  awesome and let's go ahead and create a release   so first we're going to click continue and google  is going to go ahead and create a release key   and then we're going to go out  to godot we are going to go to   project project settings we are going to set  our main scene here to billing tutorial scene   and we're going to hit closed we are going to go  to project export and then go ahead and export   out our project now i've already done this  but i'm going to go ahead and re-export it   and we'll go ahead and hit ok so you'll  see that it's going to say build successful   which is awesome and we're going to right click  open in file manager and you will see there is   our project so what we're going to do is we'll go  back to our web browser and it says drop android   bundles so you can see right here here's my apk  if we drag and drop that it will allow us to   upload our project now what we're going to call  this is we're going to call it test iap build and you'll see here you've uploaded a debuggable  apk or android app bundle well what does that   mean well it turns out when you build your  godot project you need to export it out   with debugging disabled but how do we do  that well if we go into our export menu   and we go to export project  there's a check box right here   that says export with debug and we need to uncheck  that so now let's go ahead and re-export this   and you'll see that we got another error  unable to find key store unable to export   so we need to generate our key store for  our release so let's go ahead and do that so the first thing i'm going to do is i'm going  to hit close i'm going to right click on my res   open in file manager and i'm going to open  up a command prompt awesome now what we're   going to need to do is we're going to  need to call out to our key store so key   tool dash generate a key so  gen key dash v oops dash v dash key store space bind point  cgi dot key store dash alias fine point cgi we'll say   dash key algorithm is going to be rsa  and our key size it's going to be 2048 and our validity is going to  be one or i'm sorry 10 000 and i got to make sure that space there we go   and i got to enter a key store password  so i'm going to enter in password what's my first name fine point cgi when was  your what is the name of your organizational unit   find point cgi and what's  the name of your organization and you could kind of just enter through a  lot of these and once you're good hit yes   and it has generated a self-signed  thing it's gonna ask you for a password we're gonna say password awesome so now it's  completely generated it and we now have a key   store now what are these useful for basically  they're used to sign your application so that   nobody else is able to upload an application under  your name and take over your application this you   have to keep if you don't you completely lose  your application so make sure that you keep this   in a safe place if you don't then you will never  get your application back so just remember that so now that we got this generated what we have  to do is we have to go into godot and we can   choose our release key store here in our export  menu we click on release click on the little um   file browser pick your key store your release  user is the alias that you chose so in my case   i chose fine point cgi and the password for mine  is password so go ahead and let's click export and   go ahead and export it awesome so you'll see that  the build was successful and what we're gonna do   is we will once again open up our file browser  here and grab our apk open up our google play   console and we are going to go ahead and upload  it so let's just go ahead and drag it over   and it will upload it awesome so you can see that  it did accept it don't worry about this little   error message here this is just literally because  we did it once and we made that mistake but now   we don't have to worry about that so we can go  ahead and get rid of that one so now we have our   test release we can hit save and we can review  our release so you'll see that it says warning   your app cannot be published yet complete the  steps listed in the dashboard we'll get to that   in a second but we're going to go ahead and roll  out an internal testing release so click on that   yeah go ahead and roll that out awesome so  now we've got a testing release out here and   we unfortunately can't promote it to closed  testing or open testing or production testing   until we get our app store set up so what we  need to do is we need to go to our dashboard   and we need to set up our application here  so if we go to view tasks you can see that   we have all these things that we got to get done  so let's go ahead and run through them real quick   so if we go to app access all functionality is  available without special access that's fine   and let's go back to our dashboard ads no we don't  have ads although if yours does you can say yes   save back content rating start a  questionnaire email address fine point cgi   at gmail.com our category is let's say it's a  game continue no no we don't have any of this   we don't have any of this we don't have any  of that don't have any crude humor no no no   yes we allow them to purchase digital  goods no we don't have random prizes   this is up to you we'll say yes for this  one no no no no we don't have any swastika   or anything like that in it go ahead and hit  save hit next and you'll say hey you're good   and uh you can see that your app needs to be  further reviewed for south korea but i'm not   really worried about south korea right now so go  back to the dashboard and you will see that there   is some other things that we need to do oops  not this one up here content rating oh come on we're gonna say no to everything we're going to go ahead and hit submit and  you'll see that the con the current rating   is good so we'll go back to dashboard  we're going to come down here   target audience and we got to see what we're  targeting i'm going to target 13 to 15 year olds   and no it's not going to be appealing to  children and we're going to say yup that's   good so go ahead and hit save go back news app  are we an app a news app no we're not a news app go back and now we need to go ahead and manage  how our application is organized and presented   so we're going to go ahead and click that  it is a game and we are going to say it is a   i don't know simulation game sure email  address will say find point cgi gmail.com and   i don't have a website so that's all fine external  um now i don't really need that but if you guys   want it you can we're gonna go ahead and save that  and go back to our dashboard which as you can see   they don't have one of the things that frustrates  me is all this is just awful to use by the way   uh go back to dashboard and scroll  down setting up your store list   all right so now that we're at this  point and i know like i've been   running through this extremely fast but it's  just it's just something you have to do uh   for a short description we're just gonna say  test tutorial full description test tutorial and for graphics i actually have built my own  graphics here and they're just white boxes   because it um google requires these for you to  be able to post your stuff up on the google store   so i'm gonna go ahead and drag that on feature  graphic we'll just drag that on scroll down   phone shots it says that you  need two of them so we'll just   upload both of them and then we're going to  do the same exact thing upload two of them and for tablet 10-inch we'll upload two of them  there we go and we're going to go ahead and hit   save so now that that's done we're going to go  ahead and go back to our dashboard and now that   we've gotten all that done we need to go ahead and  create our item that we're going to be purchasing   so we need to scroll all the way down here  click on in app products here and then go   ahead and create a product and our product  id we're gonna make that the same as our gdos   product id so if you come down here you can  see test sku so let's go ahead and control   c and control v that so you'll have a little  skew there and it says hey it must start with a   number or a lowercase letter can contain numbers  zero through nine lowercase letters and periods   so that should be okay and then we're going to  name it test sku and we're going to say this   is our test sku and for our price we're going to  set our price to be 10 bucks nice and expensive   so now let's go ahead and hit save and your changes could not be saved so you can see that i needed to lower  case everything so i'm gonna have to copy   that and save it awesome so now we have ourselves  a test sku item that people can purchase so   i'm gonna go ahead and activate that and now  it's active so now i can actually purchase it   so now we're gonna have to go back into  our godot project we're gonna have to paste   our new query details here and  here to make sure that we have it   and you'll see that i do have a small little  function here that i added and the reason why   i added it is because i wanted to make sure that  our query detail would work properly you don't   have to have this but i have it just in case it's  basically just passing this little connect here to   here so just go ahead and add that if you'd  like so now go ahead and hit project export   i'll change my code to four you guys just go  ahead and increment it by one and go ahead and   hit export and save and okay and it's going to go  ahead and export all right so now that that's been   exported you'll see that we have our little apk  here we're gonna go over to our in-app purchase   section here we're gonna scroll up we're gonna go  back to our internal testing and we are gonna go   ahead and create a new release now we're going  to go ahead and grab our apk and we're going to   paste it into the app bundles or drag it into  the app bundles and i'm just going to call this   release number i think this is 4 by now  so i'll just say release number four   we're gonna go ahead and save that we're going  to review it and then we're gonna go ahead and   start rolling it out to our internal testing  so we'll click on that we're gonna roll it out awesome so now this is available to our internal  testers so now we need to go ahead and install   it on our machine so what we can do is we can come  in here and we can go over to our internal testing   track and we can click on testers we can come down  here and click copy link and go ahead and open   up a new tab paste and go ahead and paste it and  you'll see welcome to the internal testing program   you know i've already been a part of the program  but if you click this you can actually join   the program right here and then once you've joined  go ahead and hit install the public version on   google play so we'll go ahead and install that and  it says that i have it installed which is actually   a lie but that's okay we'll click on that and  it'll say hey do you want to install this and on   what device now i want to install it on my google  pixel so we're going to go ahead and click install   and it'll ask for your authentication now i've  already blurred this out for you guys so you guys   can't see it but basic is going to ask for your  google account authentication information so we're   going to go ahead and hit next and you'll see it's  going to get sent out to your device and installed   remotely onto your device okay and now you can see  it on my google device so i'll go ahead and click   on it and right before i click on it actually i'm  going to go ahead and open up a command prompt   and type adb log cat and that's going to go ahead  and just log my console so i can actually see   what's going on in this computer so  i'm going to go ahead and click on the   api tutorial or the in-app purchase tutorial and  then i'm going to go ahead and click on purchase   demo item and you will see it has popped up with  our item i'm going to go ahead and click one tap   to buy it's going to go ahead and process it  it's going to pay for it and don't worry it's   not going to charge you but it did purchase it and  now i'm going to go ahead and use that item now if   you hit ctrl a ctrl c on your console here and  then we go ahead and open up visual studio code we open up a new file and we open this up let's  go ahead and take a look at some of our logs here   so if we hit control f good oh i have  a lot of godot in here so let's see   what it did so item was consumed so  we successfully consumed our item   billing account happened so it actually build  from my account if i scroll up here it also   let's see consumed that item it acknowledged  our purchase here of this token item right here   it went through and did our input  channel object for our billing activity   it went through and acknowledged our purchase  it went through and pulled back a null object so   you might want to look at that right it got  our account information to do the purchase it pulled back our object here so you can see  here's our actual object our in-app purchase   object so that's something that's great because it  allows us to say hey yeah here's the object that   we purchased and all of that happy jazz so that  way we can actually go and um you know use it   for our own purpose right so you could say this  person has this this i guess this object now right   and you can see here that it went and fetched  our tokens and all of our objects here awesome   so i know that this has been a really long  tutorial and i know this has been kind of   scattered shot a little bit because  it's kind of complicated to put together   but that's really all you have to  do to get in-app purchases to work so if you have any questions throw them in the  comments below because this is a very complicated   system and i don't want you guys to get completely  lost so go ahead and just throw a comment below   if you have questions and i'm more than happy to  sit down and help you guys out i will be uploading   my source code out to github as well so i'm going  to leave a link in the description below for that   but that's all i have for you guys today so if you  like this video go ahead and hit that like button   if you dislike this video go ahead and hit that  dislike button because i am here to make content   for you guys if you guys have any suggestions  or anything that you guys want me to cover   in the future also throw that in the comments  below because this was a viewer suggested video   and again i'm here to make content for you  guys so i want to know what you guys want   so thank you guys so much again for  watching and i'll see you all next time thanks you

Channel: FinePointCGI

Views: 2,634

Keywords: godot, godot engine, godot game engine, godot tutorial, godot engine tutorial, godot android, godot inapp purchases, in-app purchases, godot 2d, godot 3.2, godot creating accounts, godot engine firebase, advanced godot | deploying admob ads with godot 3.2, what is godot, godot getting started, godot firebase, getting started with godot, godot firebase tutorial, godot beginner tutorial, Advanced Godot | Creating In-App Purchases

Id: qejP2VwvlYE

Length: 46min 44sec (2804 seconds)

Published: Tue Jul 06 2021

Reddit Comments

[u/HardcoreMuse]

This is great, thanks! Any chance of adding a tut for leveraging Ads?

[u/finepointcgi]

Hey guys,

Im back with another tutorial this time we are doing In App Purchases. If you have any questions let me know!

Thanks,

Mitch

[u/Xornedge]

I’ll save this one for when i learn how to fully make a game.