Construct 2 Indonesia Manual: Bab Plugin Reference - 13. IAP

IAP singkatan dari (In-App Purchases). Plugin: IAP memungkinkan akses ke fungsi pembelian di berbagai toko (Store).

Toko (Store) yang didukung

Saat ini Plugin: IAP mendukung Platform dari Store berikut:

• Windows Store (Windows 8+ apps)
• CocoonJS
• Blackberry 10
• Amazon Appstore
• Tizen

Penggunaan dasar

Untuk mengakses fitur pembelian dalam aplikasi (In-app Purchase), penggunaan dasarnya adalah sebagai berikut:

1. Pada Event: Start of Layout, gunakan Action: Add product ID untuk menambahkan ID produk yang akan Anda gunakan, misalnya: “product1, product2, product3”.
   
   
2. Setelah itu (masih dalam Event: Start of Layout), gunakan Action: Request store listing. Ini akan mengunduh nama dan harga produk yang diberikan. Beberapa Platform memerlukan informasi ini tersedia agar fitur IAP berfungsi.
   
   
3. Saat Condition: On store listing success terpicu, maka daftar produk dan harga akan tersedia, dan pembelian dapat mulai dilakukan atau dicek dengan Condition: Has product.

Terminology

Plugin: IAP menggunakan ID Produk untuk merujuk ke item individual yang tersedia untuk dijual. Ini adalah String unik yang singkat, misalnya: “myitem”. Beberapa Store merujuk hal ini dengan cara yang berbeda, seperti: “SKU”. Ini tidak masalah; Anda tetap bisa memasukkannya sebagai ID produk, asalkan itu adalah String yang mengidentifikasi item tersebut. Hal ini biasanya juga berbeda dengan nama produk.

App purchases

Windows Store memungkinkan aplikasi itu sendiri untuk dibeli, misalnya: untuk membuka fitur premium. Plugin: IAP memiliki fitur seperti Action: Purchase App untuk mendukung hal ini. Namun Platform lainnya tidak mendukung aplikasi itu dalam melakukan pembelian. Untuk memastikan Event Anda kompatibel dengan Store yang lain, membeli aplikasi tersebut akan diterjemahkan untuk membeli produk dengan ID: “app”.

Menggunakan mode pengujian (Test Mode)

Properti Test Mode dari Object: IAP harus diset ke YES selama pengembangan, namun harus diset ke NO sebelum dipublikasikan. Dalam Test Mode, pembelian Store disimulasikan. Store yang berbeda memiliki terminologi yang berbeda dalam hal ini, termasuk Test mode, Sandbox mode, atau Developer mode. Setiap Store juga menangani Test mode dengan caranya masing-masing; dalam banyak kasus semua pembelian akan dilupakan setiap kali Anda me-restart aplikasi, memungkinkan Anda untuk menguji agar alur pembelian berfungsi.

Publishing

Saat memublikasikan aplikasi Anda, Anda perlu menyiapkan Store dengan daftar barang yang ingin Anda siapkan untuk dijual. Proses untuk ini berbeda pada setiap platform dan biasanya merupakan bagian dari proses publikasi. Pastikan untuk mencatat dengan seksama setiap ID produk yang Anda gunakan pada Event Anda, dan pastikan Anda menambahkan item ke setiap ID produk saat mempublikasikan. Perhatikan bahwa seperti yang dijelaskan di bagian ‘App purchases’ di atas, jika Anda menggunakan pembelian aplikasi, Anda harus menambahkan produk dengan ID “app” untuk mewakili pembelian aplikasi itu sendiri di semua Store kecuali di Windows Store.

IAP Properties

• Test mode
  Lihat bagian ‘Menggunakan mode pengujian’ di atas.
  
  
• Item group ID (under Tizen store settings)
  Pengaturan ini hanya berlaku untuk aplikasi yang dipublikasikan ke Tizen Store. Saat mempublikasikan aplikasi Anda, buat grup item untuk item IAP yang Anda inginkan tersedia di aplikasi, lalu masukkan ID grup item di Property ini.

IAP Conditions

• Has product
  Untuk menguji apakah Product ID tertentu telah berhasil dibeli oleh user. Perhatikan bahwa dalam beberapa kasus, ini akan FALSE selama beberapa detik pertama aplikasi berjalan meskipun user telah membeli item tersebut, dan kemudian menjadi TRUE saat Store selesai memuat status Store di latar belakang. Usahakan untuk menghindari penggunaan Condition ini sebelum Condition: On store listing success terpicu.
  
  
• Is app purchased
  Pada Windows Store, ini digunakan untuk menguji apakah aplikasi itu sendiri telah dibeli. Pada Platform lain, ini digunakan untuk menguji jika Product ID “app” telah dibeli.
  
  
• Is store available
  TRUE jika Store yang didukung saat ini tersedia dan pembelian dapat dilakukan. FALSE jika pada Platform yang tidak didukung atau jika tidak ada Store tersedia (seperti di web browser biasa).
  
  
• On any purchase success
  
• On any purchase failed
  Dipicu setelah pembelian selesai untuk menunjukkan apakah berhasil (dan itemnya sekarang telah dimiliki) dan ataukah tidak berhasil (Unsuccessful).
  
  
• On purchase success
• On purchase failed
  Dipicu setelah pembelian Product ID tertentu selesai, untuk menunjukkan apakah berhasil (dan itemnya sekarang telah dimiliki) atau tidak berhasil (Unsuccessful).
  
  
• On store listing success
• On store listing failed
  Dipicu setelah Action: Request store listing telah selesai, untuk menunjukkan apakah daftar Store berhasil diambil. Setelah Condition: On store listing success, Anda dapat memeriksa apakah produk telah dibeli, melakukan pembelian baru, dan mengambil daftar barang yang tersedia beserta rinciannya.

IAP Actions

• Add product ID
  Gunakan Action ini pada saat mulai Layout untuk menunjukkan semua Product ID yang akan digunakan oleh aplikasi. Action ini dapat digunakan beberapa kali, atau dengan daftar ID produk yang dipisahkan koma untuk menambahkan beberapa produk sekaligus. Lihat bagian tentang Penggunaan Dasar di atas untuk informasi lebih lanjut.
  
  
• Purchase app
  Pada Windows Store, Action ini meminta untuk membeli aplikasi itu sendiri. Di Platform lain, Action ini meminta pembelian Product ID “app”.
  
  
• Purchase product
  Permintaan untuk membeli produk tertentu dengan ID produknya.
  
  
• Request store listing
  Minta detail barang yang tersedia dan yang dibeli dari Store. Action Ini harus digunakan pada awal Layout. Lihat bagian tentang Penggunaan Dasar di atas untuk informasi lebih lanjut.
  
  
• Restore purchases
  Perbarui status item yang telah dibeli dari toko.
  

IAP Expressions

• AppName
  
• AppPrice
  Mengambil nama dan harga aplikasi itu sendiri di Windows Store. Di Platform lain, ini mengambil nama dan harga Product ID “app”.
  
  
• Error message
  Dalam Triggered Condition: Failed, ini mengambil teks pesan kesalahan jika tersedia.
  
  
• ProductID
  ID produk yang relevan dalam Condition yang dipicu, misalnya: Condition: On any purchase success.
  
  
• ProductName(productid)
• ProductPrice(productid)
  Mengambil nama atau harga suatu produk yang tersedia untuk dibeli berdasarkan ID produknya. Informasi ini hanya tersedia setelah Triggered Condition: On store listing success.