Codeless IAP

Codeless IAP adalah cara termudah untuk menerapkan pembelian dalam aplikasi di aplikasi Unity Anda. Editor Unity menawarkan antarmuka untuk mengkonfigurasi integrasi IAP dasar menggunakan penulisan skrip minimal.

Codeless IAP menangani transaksi IAP yang sebenarnya tanpa memerlukan kode. Menerapkan Codeless IAP adalah proses dua langkah menggunakan Editor:

1. Tambahkan IAP Buttons ke permainan Anda.
2. Tentukan Products Anda di IAP Catalog.

Sistem Unity Purchasing mengkonfigurasi Produk yang Anda ramai dalam katalog pada waktu yang berjalan. Ketika pemain memilih IAP Button, itu memulai aliran pembelian untuk Produk yang terkait.

Note: Anda masih perlu menggunakan scripting untuk menentukan bagaimana pemain mengakses konten yang baru dibeli. Untuk informasi lebih lanjut, lihat bagian Purchase fulfillment di bawah ini.

Menerapkan Codeless IAP

Sebelum memulai, instal SDK terbaru. Lihat dokumentasi untuk informasi lebih lanjut.

Menambahkan IAP Tombol ke Adegan Anda

Untuk menambahkan IAP Button ke Adegan Anda, di Editor Unity, pilih Window > Unity IAP > Create IAP Button.

Produk Populasi di Katalog IAP

Buka IAP Catalog GUI salah satu dari dua cara:

• Pilih Window > Unity IAP > IAP Catalog.
• Atau, dengan IAP Button yang dipilih, cari komponen IAP Button (Script) di InspectorJendela Unity yang menampilkan informasi tentang Pengaturan GameObject yang dipilih saat ini, aset atau proyek, memungkinkan Anda untuk memeriksa dan mengedit nilai. More info
  Lihat di Glossary, lalu klik IAP Catalog….

Selanjutnya, gunakan GUI untuk mendefinisikan atribut berikut untuk setiap Produk dalam katalog Anda.

• Sebuah Product ID dengan yang berkomunikasi dengan toko aplikasi (note that you can override this ID with unik store-specific ID melalui opsi Advanced).
• A Product Type (Consumable, Non-Consumable, atau Subscription).

Note: GUI IAP Catalog menyediakan alat tambahan untuk mengkonfigurasi Produk Anda. Sebelum mengekspor katalog untuk mengunggah ke toko masing-masing, Anda harus mengisi deskripsi dan informasi harga serta. Untuk informasi rinci tentang pengaturan ini, lihat dokumentasi di .

UnityPurchasing

SDK IAP harus menginisialisasi untuk pembelian dalam aplikasi untuk bekerja. Ini terjadi secara otomatis ketika instance pertama dari beban Codeless IAP Button atau IAP Listener pada waktu berjalan. Namun, Anda mungkin perlu menginisialisasi SDK sebelum Tombol IAP atau Pendengar IAP muncul dalam permainan Anda (misalnya, melayani tawaran setelah peluncuran aplikasi). Dalam kasus ini, periksa Automatically initialize UnityPurchasing (recommended) di bagian bawah jendela IAP Catalog. Ini memastikan bahwa menginisialisasi segera ketika aplikasi dimulai, dan menghilangkan ketergantungan pada siklus hidup instance tanpa kode.

Untuk bekerja, katalog Anda harus berisi setidaknya satu Produk.

Note: Anda dapat menggunakan auto-initialize bersama dengan IAP Buttons atau Listener. Dalam hal ini, SDK menginisialisasi ketika permainan dimulai bukan ketika instance pertama dari Tombol IAP atau beban Listener di SceneAdegan berisi lingkungan dan menu permainan Anda. Pikirkan setiap file Adegan unik sebagai tingkat yang unik. Di setiap Adegan, Anda menempatkan lingkungan, hambatan, dan dekorasi, pada dasarnya merancang dan membangun permainan Anda dalam potongan-potongan. More info
Lihat di Glossary. Namun, Anda tidak boleh mengaktifkan auto-initialize jika Anda juga menginisialisasi secara manual dalam skrip, karena ini dapat menyebabkan kesalahan.

Biaya pembelian

Ketika katalog Anda mengandung setidaknya satu Produk, Anda dapat menentukan perilaku IAP Button ketika pembelian selesai atau gagal.

1. Pilih IAP Button Anda di Scene viewTampilan interaktif ke dunia yang Anda buat. Anda menggunakan Adegan Lihat untuk memilih dan posisi pemandangan, karakter, kamera, lampu, dan semua jenis lain dari Game Object. More info
   Lihat di Glossary, kemudian cari komponen IAP Button (Script) di Inspektur.
2. Pilih Produk untuk menghubungkan ke IAP Button dari daftar drop-down Product ID.
3. Buat fungsi Anda sendiri yang menyediakan pemenuhan pembelian, atau impor Aset yang melakukan ini (lihat sampel kode, di bawah).
4. Ajukan skrip fulfilment pembelian Anda ke GameObjectObjek mendasar dalam adegan Unity, yang dapat mewakili karakter, props, pemandangan, kamera, waypoints, dan banyak lagi. Fungsi GameObject didefinisikan oleh Komponen yang melekat padanya. More info
   Lihat di Glossary sebagai komponen.
5. Kembali ke komponen IAP Button (Script) di Inspektur, dan klik tombol plus (+) untuk menambahkan fungsi ke daftar On Purchase Complete (Product).
6. Seret GameObject dengan skrip pemenuhan pembelian ke lapangan acara On Purchase Complete (Product) (terangi di bawah), lalu pilih fungsi Anda dari menu dropdown.

Fulfillment script code sample:

public void GrantCredits (int credits){
    userCredits = userCredits + credits;
    Debug.Log(“You received “ + credits “ Credits!”);
} 

Jalankan permainan Anda untuk menguji IAP Button.

Fungsi tambahan

Mengekspor ke toko aplikasi

Untuk pembelian untuk fungsi, Anda harus mengkonfigurasi katalog Anda di toko aplikasi yang sesuai. Untuk melakukannya, Anda dapat mengekspor Katalog Produk Anda sebagai file CSV ke Google Play, atau sebagai file XML melalui Loader Aplikasi Apple ke iTunes Store.

Google Login

Untuk mengekspor Katalog Produk Anda untuk Google Play:

1. Di jendela IAP Catalog (Window > Unity IAP > IAP Catalog), memastikan bahwa setiap Produk memiliki didefinisikan sebagai berikut:
   * ID
   * Type
   * Title dan Description
   * Price atau Pricing Template ID
2. Gulir ke bawah, dan pilih App Store Export.
3. Pilih Google Play CSV.
4. Pilih lokasi di mana untuk menyimpan file CSV.

Untuk panduan lengkap untuk mengunggah katalog yang diekspor ke Google Play, lihat dokumentasi Facebook Twitter pada Web Browser.

BlackBerry

Untuk mengekspor Katalog Produk Anda untuk Apple iTunes:

1. Di jendela IAP Catalog (Window > Unity IAP > IAP Catalog), memastikan bahwa setiap Produk memiliki didefinisikan sebagai berikut:
   * ID
   * Type
   * Title dan Description
   * Price Tier dan Screenshot path
   * Apple SKU (berbentuk dalam iTunes Connect)
   * Apple Team ID (berdasar pada Website pengembang Apple)
2. Gulir ke bawah, dan pilih App Store Export.
3. Pilih Apple XML Delivery.
4. Pilih lokasi di mana untuk menyimpan file XML.

Untuk panduan lengkap untuk mengimpor melalui Loader Aplikasi Apple, lihat dokumentasi Aplikasi Loader pada Web browser.

Mengembalikan tombol

Beberapa toko aplikasi, termasuk iTunes, memerlukan aplikasi untuk memiliki tombol Restore. Codeless IAP menyediakan cara mudah untuk menerapkan tombol pemulihan di aplikasi Anda.

Untuk menambahkan tombol Restore:

1. Tambahkan IAP Button ke Adegan Anda (Window > Unity IAP > Create IAP Button).
2. Dengan pilihan IAP Button Anda, cari komponen IAP Button (Script) di Inspektur, kemudian pilih Restore dari menu drop-down Button Type (paling dari bidang lain komponen akan hilang dari pandangan Inspektur).

Ketika pengguna memilih tombol ini pada waktu berjalan, tombol memanggil API restorasi pembelian untuk toko saat ini. Fungsi ini bekerja di iOS App Store, Mac App Store, dan toko aplikasi Windows Store. Anda mungkin ingin menyembunyikan tombol Restore pada platform lain.

Jika pengembalian berhasil, Unity IAPUnity In App Purchase
Lihat di Glossary memanggil fungsi On Purchase Complete (Product) pada IAP Button yang terkait dengan Produk itu.

Untuk informasi lebih lanjut, lihat dokumentasi di .

Pendengaran IAP

Codeless IAP mengirimkan acara pembelian yang sukses dan gagal ke komponen IAP Button aktif dalam hierarki. Namun, mungkin ada waktu ketika sulit atau tidak diinginkan untuk memiliki IAP Button aktif ketika menangani pembelian yang sukses. Misalnya, jika pembelian terganggu sebelum menyelesaikan, upaya IAP Unity untuk memproses pembelian lagi waktu berikutnya diinisialisasi. Anda mungkin ingin ini terjadi segera setelah peluncuran aplikasi, di mana kasus IAP Button tidak akan masuk akal. Codeless IAP termasuk komponen IAP Listener tepat untuk kasus ini. Sebuah IAP Listener aktif dalam hierarki Adegan menerima setiap peristiwa pembelian yang tidak dapat dikirim ke IAP Button.

Untuk menambahkan IAP Listener:

1. Di Editor Unity, pilih Window > Unity IAP > Create IAP Listener.
2. Ikuti langkah-langkah untuk menulis skrip pemenuhan pembelian sebagai komponen GameObject.
3. Pilih IAP Listener di Adegan dan cari komponen IAP Listener (Script) di Inspektur, kemudian klik tombol plus (+) untuk menambahkan fungsi ke daftar On Purchase Complete (Product).
4. Seret GameObject dengan skrip pemenuhan pembelian ke bidang acara dalam Inspektur komponen, kemudian pilih fungsi Anda dari menu dropdown.

Mengakses fungsi diperpanjang Unity IAP

Fitur Codeless IAP tidak mengekspos sebagian besar Unity IAP. Namun, Codeless IAP diterapkan di atas API scripting yang ada, sehingga Anda dapat memodifikasi banyak fungsinya dalam script IAPButton.cs (Aset/Plugins/UnityPurchasing/script/IAPButton.cs) sesuai dengan kebutuhan Anda.

Untuk menggunakan fungsi diperpanjang Unity IAP, akses Unity IAP dan instance yang dikembalikan.

---

• 2018–05–30 Login