Mengelola dan menerbitkan permainan Anda di konsol UDP

Menggunakan Firebase dengan build UDP

Menggunakan UDP dengan layanan lain

Layanan game Google Play di Gedung UDP

Overview

Menerapkan Layanan permainan Google Play dalam game Android Anda memungkinkan Anda memanfaatkan lapisan layanan Google untuk fitur seperti pencapaian dan papan peringkat. Jika permainan Anda menerapkan layanan permainan Google Play, konfigurasi tambahan diperlukan untuk mendukung build yang menciptakan untuk toko yang berbeda.

Ketika permainan Anda invokes Layanan Google Play game, layanan Google Play game memeriksa bahwa rincian berikut cocok dengan informasi yang terdaftar di Google Play Console:

package name aplikasi
certificate aplikasi ditandatangani dengan

Jika mereka tidak cocok, pemain tidak bisa masuk ke aplikasi dengan layanan permainan Google Play.

Untuk toko-toko tertentu yang Anda publikasikan permainan Anda melalui UDP, UDP menambahkan suffix khusus untuk nama paket. Selain itu, jika Anda tidak menggunakan kunci pribadi Anda sendiri untuk menghasilkan sertifikat, UDP menghasilkan sertifikat untuk setiap membangun yang dikemas ulang. Peristiwa ini akan menyebabkan sertifikat dan/atau nama paket untuk tidak lagi mencocokkan informasi di Google Play Console. Ini akan mencegah pengguna masuk ke permainan dengan layanan permainan Google Play.

Bagian berikut menjelaskan bagaimana menyelesaikan masalah ini.

Mengkonfigurasi layanan game Google Play untuk membangun UDP

Bagian ini menjelaskan cara menghubungkan versi UDP Anda ke aplikasi Google Play sehingga layanan game Google Play dapat bekerja sama dengan mereka.

Di Google Play Console, pergi ke aplikasi target.
Play Games Services > Setup and management > Configuration.
- Jika permainan Google Play Anda memiliki layanan Google Play game yang diimplementasikan, permainan Anda sudah dikaitkan dengan proyek layanan Google Play game. Dalam hal ini:
  1. Pilih Use an existing Play Games Services project.
  2. Pilih proyek game Anda dan pilih Use.
  3. Ikuti langkah-langkah di Tautan aplikasi UDP ke layanan permainan Anda.
- Jika permainan Google Play Anda tidak memiliki layanan Google Play game yang diimplementasikan:
  1. Di halaman Pengaturan Layanan Game Play, pilih Yes, my game already uses Google APIs atau No, my game doesn’t use Google APIs.
  2. Ikuti langkah-langkah di Membuat dan menghubungkan proyek layanan permainan Google Play.

Membuat dan menghubungkan proyek layanan permainan Google Play

Bagian ini menjelaskan bagaimana membuat proyek layanan game Google Play dan menghubungkannya ke proyek cloud baru atau yang ada.

Jika Anda memilih Yes, my game already uses Google APIs di halaman Pengaturan Layanan Play Games:

Pilih proyek cloud.
Pilih Gunakan untuk membuat proyek Play Games Services baru dan menghubungkannya ke proyek cloud Anda yang ada.

Jika Anda memilih No, my game doesn’t use Google APIs di halaman Pengaturan Layanan Play Games:

Masukkan nama permainan.
Pilih Buat untuk membuat proyek Play Games Services baru dan menghubungkannya ke proyek cloud baru.

Ketika Anda membuat proyek Play Games Services baru, tautan Add credential dinonaktifkan.

Pilih Configure OAuth consent screen.
Di layar konfigurasi Play Games Services, pilih Refresh.
Opsi kredensial Tambahkan sekarang diaktifkan.
Pilih Add credential.
Ini membuka halaman Tambahkan kredensial.
Pada halaman Tambahkan kredensial:
1. Pilih Android sebagai Type.
2. Set Enable anti-piracy untuk Off. Ini memungkinkan pengguna mengakses permainan Anda jika mereka telah menginstalnya dari toko aplikasi yang berbeda dari Google Play.
3. Pada bagian Otorisasi, pilih Create OAuth client. Ini membuka popup.
4. Pilih Create OAuth Client ID dan gunakan detail dari popup untuk menyelesaikan formulir.

Ketika Anda telah menyelesaikan langkah-langkah di atas, permainan Google Play Anda dikaitkan dengan layanan permainan Google Play. Langkah selanjutnya adalah menghubungkan UDP Anda membangun layanan permainan.

Menghubungkan aplikasi UDP ke layanan permainan Anda

Ketika Anda telah menghubungkan aplikasi Anda ke layanan Google Play game Anda dapat menghubungkan aplikasi lain (UDP) ke layanan game.

Di Google Play Console, pilih Play Games Services > Setup and management > Configuration.
1. Di halaman konfigurasi Play Games Services, pilih Add credential.
Pada halaman Tambahkan kredensial:
1. Pilih Android.
2. Sitemap Ini memungkinkan pengguna mengakses permainan Anda jika mereka telah menginstalnya dari toko aplikasi yang berbeda dari Google Play.Enable anti-piracy to off. This lets users access your game if they have installed it from a different app store than Google Play.
3. Pada bagian Authorization, pilih Create OAuth client. Ini membuka popup.
4. Pilih Create OAuth Client ID dan gunakan detail dari popup untuk menyelesaikan formulir.
Dalam bentuk Buat ID klien OAuth, masukkan rincian yang diperlukan untuk membuat entri untuk salah satu build UDP Anda.
1. Di bidang Name, nama build setelah toko yang sesuai, misalnya “versi Samsung”.
2. Dalam bidang Package name, tentukan nama paket untuk membangun terdaftar dengan toko yang sesuai melalui konsol UDP. Login Nama paket khusus toko ditampilkan di konsol UDP:
  The store-specific package name is displayed in the UDP console:
  1. Pergi ke Game Saya > Publish tab.
  2. Pilih Advanced untuk toko yang sesuai. Login Nama paket ditampilkan di bagian Informasi Dasar.
    The package name is displayed in the Basic Information section.
3. Dalam bidang sertifikat, gunakan sertifikat yang digunakan untuk toko UDP yang sesuai. UDP menandatangani aplikasi dengan sertifikat baru setelah operasi Repack. Login Sertifikat khusus toko ditampilkan di konsol UDP:
  The store-specific certificate is displayed in the UDP console:
  1. Pergi ke Game Saya > Publish tab.
  2. Pilih Advanced untuk toko yang sesuai. Login Sertifikat ditampilkan di bagian Informasi Dasar.
    
    Note
    openssl x509 -in [downloaded-pem-filepath] -fingerprint -noout%
  3. Salin SHA–1 dari konsol UDP ke bidang sertifikat.
Ketika Anda telah menyelesaikan formulir, pilih Create dan kembali ke Google Play Console.
Pilih Refresh OAuth clients.
Pilih klien OAuth baru Anda.
1. Pilih Save changes untuk menyimpan kredensial.
Ulangi langkah-langkah di atas untuk setiap bangunan UDP khusus yang ingin Anda link ke aplikasi Google Play Anda.

Anda dapat melihat UDP membangun Anda telah terhubung ke aplikasi Google Play Anda di Google Cloud Platform > Google API & Layanan dashboard, di bawah Credentials.

Langkah-langkah ini memungkinkan layanan game Google Play untuk bekerja dengan sukses pada semua versi toko UDP yang terhubung dengan cara itu, termasuk Mi GetApps (whose SDK mengintegrasikan versi lama Layanan Google Mobile, yang menciptakan konflik).

Note: Setiap perubahan sistem Google dapat mempengaruhi solusi yang dijelaskan di atas. Untuk informasi lebih lanjut tentang informasi pemecahan masalah Google, lihat Dokumentasi Google.

Menggunakan Cloud Build dengan UDP

Anda dapat menggunakan Layanan integrasi berkelanjutan untuk proyek Unity yang mengotomatiskan proses pembuatan build pada server Unity. More info
Lihat di Glossary untuk menyebarkan permainan Anda ke konsol UDP dalam cara berikut:

Unggah APK Anda ke Build Cloud, dan menyebarkannya ke UDP dari sana
Bangun permainan Anda dengan Build Cloud, dan menyebarkannya ke UDP dari sana

Mendorong build ke konsol UDP melalui Cloud Build

Bagian ini menjelaskan cara menggunakan Cloud Build untuk mendorong permainan Anda ke UDP. Dalam Editor Unity, aktifkan Build Cloud di jendela Project SettingsPengumpulan yang luas dari pengaturan yang memungkinkan Anda untuk mengkonfigurasi bagaimana Fisika, Audio, Jaringan, Grafik, Input dan banyak bidang lain dari jangkauan proyek Anda. More info
Lihat di Glossary.

Menggunakan Cloud Build di Editor untuk menyebarkan permainan Anda ke UDP

Untuk menyebarkan permainan Anda ke UDP melalui fitur Build Cloud di Editor Unity, Anda perlu mengunggah build UDP Anda dan mendorongnya ke UDP.

Pada tab Cloud Build dari jendela Pengaturan Proyek, jika Anda belum mengunggah build sebelum, pilih Upload Build.
FILE:
- Pilih APKFormat paket Android output oleh Unity. Sebuah APK secara otomatis digunakan untuk perangkat Anda ketika Anda memilih File > Build & Run. More info
  Lihat di Glossary dari build UDP Anda
- Masukkan ruang LABEL% yang berguna
- Mengatur bidang PLATFORM ke Android.
Pilih UPLOAD, dan biarkan menyelesaikan proses unggah.
Pada tab Cloud Build dari jendela Pengaturan Proyek, cari build yang diinginkan dari build History timeline dan pilih Push to Unity Distribution Portal.
1. Verifikasi bahwa Anda ingin mendorong, dan bahwa tindakan selesai.

Menggunakan Dashboard Unity untuk menyebarkan permainan Anda ke UDP

Untuk menyebarkan permainan Anda ke UDP melalui fitur Build Cloud di Dashboard Unity, Anda perlu mengunggah UDP Anda membangun ke Dashboard Unity dan mendorongnya dari sana ke UDP.

Di, arahkan ke Cloud Build Proyek Anda > History.
Pilih Upload, lalu pilih file APK Anda.
Di bidang Platform, pilih Android.
Pilih Upload.
Pilih menu Lainnya di sebelah build Anda untuk memperluas menu drop-down.
Pilih Push to Unity Distribution Portal.

Membangun dan menyebarkan melalui Build Cloud

Jika Anda menggunakan Tim Unity Lanjutan, Anda dapat .

Di tab Build Cloud dari jendela Pengaturan Proyek:

Pilih Manage Build Targets > Add new build target
Di jendela TARGET SETUP, set kolom PLATFORM ke Android dan masukkan TARGET LABEL yang berguna.
Pilih Next: Save.
Pilih Start Cloud Build, lalu pilih target build yang Anda buat.

Push build Anda ke UDP langsung melalui Unity Cloud Build Developer Dashboard (seperti yang ditunjukkan di atas).

Layanan interoperabilitas

UDP dapat memberitahu layanan lain yang digunakan oleh permainan Anda yang toko adalah permainan yang diunduh dari.

Informasi ini dapat digunakan dalam banyak cara, dengan layanan Unity serta layanan pihak ketiga atau layanan Anda sendiri.

Misalnya, memungkinkan Anda menyetel pengaturan permainan Anda berdasarkan aturan yang Anda mendefinisikan, seperti yang menyimpan permainan diunduh.

Bagian ini menjelaskan cara membiarkan layanan lain mendapatkan akses ke informasi ini, dan termasuk example.

Bagaimana cara kerjanya?

Ketika permainan pertama Anda meluncurkan pada perangkat pemain, UDP menciptakan dan menjatuhkan file udp.json di Jalur Data Persistent game. File ini berisi bidang udpStore, yang menunjukkan bahwa menyimpan permainan diunduh. Perhatikan bahwa informasi untuk menggunakannya cara yang Anda maksudkan.

Sitemap Ini tidak menambahkan izin baru ke dalam manifestasi permainan Anda.Note: This doesn’t add any new permission into your game manifest.

Locating udp.json

File udp.json disimpan dalam:

Application.PersistentDataPath + '/Unity' + /Application.CloudProjectID + /udp/udp.json

Where:

Application.PersistentDataPath adalah jalur data persistent permainan Anda
Application.CloudProjectID adalah ID proyek Unity permainan Anda

Berikut adalah contoh path ke file udp.json:

path/storage/emulated/0/Android/data/com.mystudio.mygame/files/Unity/c83d2de2-de74-4b75-83fc-ade948bda064/udp/udp.json

Where:

Application.PersistentDataPath= path/storage/emulated/0/Android/data/com.mystudio.mygame
Application.CloudProjectID= c83d2de2-de74-4b75-83fc-ade948bda064

WordPress.org

File udp.json berisi informasi berikut:

{"key":"UDP","udpStore":"StoreName","udpClientId":"value_of_udpClientId","CloudProjectId":"value_of_CloudProjectId"}

Bidang udpStore mengandung nilai UDP menyimpan permainan Anda diunduh.

Berikut adalah contoh file udp.json:

{"key":"UDP","udpStore":"Huawei","udpClientId":"icjaB7wmu_q7AOjrSLH8yw","cloudProjectId":"bc2be074-09f3-450f-8e98-a0f79c9746f7"}

Dalam contoh ini, permainan diunduh dari HUAWEI AppGallery.

Tip: menggunakan JSONUtility.FromJsonOverwrite untuk membaca isi file sebagai aset teks.

Login Nilai toko

Tabel di bawah daftar nilai udpStore yang dapat Anda harapkan untuk toko yang tersedia di UDP.

Ini sensitif terhadap kasus.

Toko (nama saluran pada UDP)	Nilai untuk udp Login
UDP Sandbox (untuk build UDP generik)	UdpSandbox
ONE store	OneStore
Login Login	Apptutti
Mi GetApps (Xiaomi)	XiaomiStore
Appstore	Huawei
Toko Game QooApp	QooApp
Uptodown	Uptodown
SHAREit	ShareIt
JioGames	JioGames
Legion Store	Legion

Menggunakan udpStore dengan Konfigurasi Jarak Jauh

memungkinkan Anda menyetel pengaturan permainan Anda tanpa menyebarkan versi baru dari aplikasi Anda. Ketika pemain meluncurkan permainan Anda, Remote Config mendeteksi atribut kontekstual yang digunakan sebagai kondisi Rule (berdasarkan Unity, aplikasi, pengguna, atau kriteria khusus yang Anda tentukan). Layanan kemudian mengembalikan pengaturan yang disesuaikan untuk setiap pemain sesuai dengan Peraturan yang berlaku untuk mereka.

Gunakan udpStore sebagai atribut dalam kondisi Rule Anda, sehingga Anda dapat menentukan pengaturan permainan yang tergantung pada mana UDP menyimpan permainan diunduh dari.

Untuk menerapkan udpStore dengan Remote Config, ikuti langkah-langkah ini.

Unduh dan instal paket UDP.
Unduh dan instal paket Config Unity RemoteAplikasi yang dapat diunduh dirancang untuk membantu pengembangan Android, iOS, dan TVOS. Aplikasi ini terhubung dengan Unity sementara Anda menjalankan proyek Anda dalam Mode Bermain dari Editor Unity. More info
Lihat di Glossary. Sitemap
Buat sebuah AppAttributes struct, yang setidaknya memiliki parameter, “udpStore”:
public struct AppAttributes { public string udpStore; }
Dalam kode permainan, menerapkan Remote ConfigManager. Login
Ketika memanggil FetchConfigs, membuat instance baru dari AppAttributes struct, membaca file data toko UDP dari: Aplikasi. PersistentDataPath + '/Unity' + / Aplikasi.CloudProject Sitemap Gunakan JSONUtility.DariJsonOverwrite untuk membaca isi file sebagai aset teks.
{ string udpFilePath = System.IO.Path.Combine(Application.persistentDataPath, "Unity", Application.cloudProjectId, "udp", "udp.json"); string udpFileContents = System.IO.File.ReadAllText(udpFilePath); var appAttr = JsonUtility.FromJson<AppAttributes>(udpFileContents); Unity.RemoteConfig.ConfigManager.FetchCompleted += ConfigManager_FetchCompleted; Unity.RemoteConfig.ConfigManager.FetchConfigs(null, appAttr); }
Pastikan struct AppAttributes digunakan di ConfigManager. Login
Buka pengaturan Remote Config (Services > Remote Config > Configure), dan buat parameter yang ingin Anda ubah berdasarkan toko UDP.
Ketika parameter diatur, dan berperang dalam kode permainan, buat aturan untuk setiap toko di jendela Remote Config.
Dalam setiap kondisi aturan, masukkan: aplikasi.udpStore == "[storeName]"
- nilai untuk udp Login
Untuk mengaktifkan pengaturan, pilih kotak centang di sebelah nama aturan di panel kiri dalam pengaturan Konfigurasi Jarak Jauh.
Membangun aplikasi ke perangkat dan memastikan aturan diterapkan dengan benar, dan mengirimkannya.

Menerapkan item IAP untuk UDP dengan Unity IAP

Jika Anda ingin menerapkan UDP menggunakan Unity IAPUnity In App Purchase
Lihat di Glossary, pertama.

Note: Jika Anda memilih untuk mengimplementasikan UDP dengan versi Unity IAP 1.22.0-1.23.5 (dalam menggunakan paket UDP) kemudian menerapkan melalui Unity IAP hanya.

Unity IAP secara otomatis menangani berikut:

UDP
Querying persediaan produk IAP toko
Meminta untuk membeli produk
Mengumpulkan barang yang dibeli

Namun, permainan Anda harus menggunakan fungsi serupa Unity IAP (seperti awalisasi dan pembelian) sesuai dengan .

Ketika Anda telah menerapkan pembelian dalam aplikasi permainan Anda dengan Unity IAP, mengambil langkah-langkah berikut untuk mengatur UDP dengan Unity IAP.

IAP Inventaris

Dengan Unity IAP (pengimplementasikanan kode)

Mencapai produk IAP didefinisikan dalam Editor

Ketika mengambil produk IAP untuk lulus ke metode queryInventory, invoke ProductCatalog.LoadDefaultCatalog(). Ini mengembalikan produk IAP yang didefinisikan dalam IAP Catalog Editor (Services > Unity IAP > IAP Catalog).

Contohnya:

var catalog = ProductCatalog.LoadDefaultCatalog();

foreach (var product in catalog.allValidProducts)
{
   if (product.allStoreIDs.Count > 0)
   {
       var ids = new IDs();
       foreach (var storeID in product.allStoreIDs)
       {
           ids.Add(storeID.id, storeID.store);
       }
       builder.AddProduct(product.id, product.type, ids);
   }
   else
   {
       builder.AddProduct(product.id, product.type);
   }
}

Mencapai informasi produk IAP dari konsol UDP

Jika Anda berencana untuk memodifikasi Katalog IAP permainan Anda di Konsol UDP, siapkan permainan Anda untuk mengambil informasi produk IAP dari Konsol UDP.

Ketika mengambil produk IAP untuk lulus ke metode queryInventory, invoke builder. TambahkanProduk untuk mengambil produk IAP tertentu yang didefinisikan dari konsol UDP:

builder.AddProduct(product.id, product.type, new IDs{})

Untuk menampilkan harga produk, diformat dengan mata uang, gunakan productInfo.Value.Price.

Mencapai IAP Katalog dari konsol UDP

Untuk mengambil semua produk IAP yang didefinisikan pada Konsol UDP, jangan beri metode pengambilan produk IAP. Game Anda kemudian akan mengambil seluruh Katalog IAP dari Konsol UDP.

Catatan: Unggah file CSV produk IAP di Konsol UDP sepenuhnya menimpa Katalog IAP Anda.

Mengisi di Katalog IAP dengan paket Unity IAP

Menambahkan dan mengkonfigurasi pembelian dalam aplikasi Anda untuk UDP.Catalog all your in-app purchases for UDP.

Note: Jika Anda tidak menggunakan Katalog IAP di klien game Anda (misalnya, Anda mempertahankan item IAP Anda hanya pada server game Anda) Anda harus tetap membuat IAP Anda Katalog di konsol UDP.

Di Editor Unity, pilih Services > Unity IAP > IAP Catalog.
Pilih Add Product dan masukkan rincian untuk setiap produk IAP.
1. Tambahkan harga untuk item IAP di bawah Konfigurasi Portal Distribusi Unity.
Untuk menyimpan produk IAP Anda ke konsol UDP, pilih Sync to UDP. Apakah ini untuk setiap produk IAP yang Anda buat.

Untuk memastikan Katalog IAP disimpan dengan benar, periksa bahwa item yang ditambahkan ditampilkan di konsol UDP.

Mengelola dan menerbitkan permainan Anda di konsol UDP

Menggunakan Firebase dengan build UDP

Manual Unity

Menggunakan UDP dengan layanan lain

Layanan game Google Play di Gedung UDP

Overview

Mengkonfigurasi layanan game Google Play untuk membangun UDP

Membuat dan menghubungkan proyek layanan permainan Google Play

Menghubungkan aplikasi UDP ke layanan permainan Anda

Menggunakan Cloud Build dengan UDP

Mendorong build ke konsol UDP melalui Cloud Build

Menggunakan Cloud Build di Editor untuk menyebarkan permainan Anda ke UDP

Menggunakan Dashboard Unity untuk menyebarkan permainan Anda ke UDP

Membangun dan menyebarkan melalui Build Cloud

Layanan interoperabilitas

Bagaimana cara kerjanya?

Locating udp.json

WordPress.org

Login Nilai toko

Menggunakan udpStore dengan Konfigurasi Jarak Jauh

Menerapkan item IAP untuk UDP dengan Unity IAP

IAP Inventaris

Dengan Unity IAP (pengimplementasikanan kode)

Mencapai produk IAP didefinisikan dalam Editor

Mencapai informasi produk IAP dari konsol UDP

Mencapai IAP Katalog dari konsol UDP

Mengisi di Katalog IAP dengan paket Unity IAP