Membuat dan mengubah Pengaturan Jarak Jauh

Note: sekarang tersedia sebagai preview packageA preview* paket dalam pengembangan dan belum siap untuk produksi. Paket dalam pratinjau mungkin ada tahap perkembangan, dari tahap awal hingga penyelesaian dekat.
Lihat di Glossary. Remote Config adalah penawaran yang ditingkatkan yang memungkinkan Anda untuk mengubah perilaku dan penampilan permainan Anda tanpa memerlukan biner baru. Anda dapat mengaktifkan atau menonaktifkan fitur, mengubah spesifikasi permainan Anda untuk menargetkan audiens tertentu, atau menjalankan acara khusus dengan menjadwalkan rilis konten baru. Sitemap

Layanan Unity and the Layanan Analisis Unity for your Unity project. Once you have enabled AnalyticsUnity Analytics
Lihat di Glossary, open the Analytics dashboard and go to the Remote SettingsPengaturan jarak jauh adalah variabel game yang dapat Anda set jarak jauh di Dasbor Analisis Anda. More info
Lihat di Glossary page to create and change the Remote Settings values. See Menggunakan Pengaturan Jarak Jauh dalam proyek Unity to learn how to access these Remote Settings values in your game or application.

Layanan Analytics menyediakan dua konfigurasi Pengaturan Jarak Jauh:

1. Layanan Analytics mengirimkan pengaturan konfigurasi Rilis ke komputer dan perangkat yang berjalan secara teratur, non-development build aplikasi Anda.

2. Layanan Analytics mengirimkan pengaturan konfigurasi Pengembangan ke komputer dan perangkat yang menjalankan development buildsMembangun pengembangan termasuk simbol debug dan memungkinkan Profiler. More info
   Lihat di Glossary (yaitu, membangun dibuat dengan bendera Pembangunan Membangun diperiksa pada Membangun jendela Pengaturan). Mode bermain dalam jumlah Editor Unity sebagai pembangunan build.

Nilai pengaturan dapat berupa jenis primitif berikut: Int, Float, String, atau Bool. Aturan untuk menetapkan nilai:

• Nilai Int adalah 32-bit integers (–2147483648 to 2147483647).

• Nilai Float adalah single-precision, 32-bit floating-point numbers (sekitar –3.4x10^{38 g} sd 3.4x10^{38 g}).

• String terbatas pada 1024 karakter.

• Anda harus menspesifikasikan nilai boolean dengan string “true” atau “false”.

Menambahkan Pengaturan Jarak Jauh

Untuk menambahkan Pengaturan Jarak Jauh:

1. Di Anda, buka halaman Remote Settings.

2. Mengatur Configuration ke Release atau Development untuk pengaturan.

3. Klik ADD NEW KEY-VALUE (di bagian atas daftar pengaturan).

4. Masukkan nama untuk kunci.

5. Mengatur jenis nilai.

6. Masukkan nilai default.

7. Klik tombol Save.

8. Klik tombol Sync untuk menerbitkan perubahan Anda. (Anda tidak perlu mengklik tombol Sync setelah membuat setiap pengaturan individu; Anda dapat menunggu untuk menyinkronkan pengaturan Anda sampai Anda menyelesaikan membuat semua perubahan pada konfigurasi saat ini.)

Sitemap Untuk menambahkan nilai yang ditargetkan pada segmen yang berbeda, simpan pengaturan nilai kunci default dan kemudian edit. Pilihan segmen hanya muncul ketika Anda mengedit pengaturan, bukan ketika Anda pertama kali membuat satu.Note: To add values targeted to different segments, save the default key-value setting and then edit it. The segment options only appear when you edit a setting, not when you first create one.

Mengedit Pengaturan Jarak Jauh

Untuk mengedit Pengaturan Jarak Jauh:

1. Buka halaman Remote Settings di dasbor Analytics Anda.

2. Pilih Release atau Development Configuration.

3. Klik ikon edit di sebelah pengaturan yang ingin Anda ubah.

   

4. Membuat perubahan Anda. Perhatikan bahwa mengubah nama kunci memiliki efek yang sama seperti menghapus kunci lama dan menciptakan yang baru.

5. Klik tombol Save.

6. Klik tombol Sync untuk menerbitkan perubahan Anda. Unity membaca pengaturan yang diperbarui pemain waktu berikutnya memulai sesi.

Menyelesaikan pengeditan simultan

Jika dua orang di tim Anda mengedit Pengaturan Jarak Jauh pada proyek pada saat yang sama, Anda dapat mendapatkan konflik ketika mencoba untuk menyinkronkan pengaturan yang dimodifikasi dengan layanan.

Ketika konflik terjadi, Anda memiliki opsi berikut:

OVERWRITE

Menyiapkan semua perubahan pada layanan karena Anda sinkronisasi terakhir dan mendorong pengaturan Anda ke layanan. Ketika Anda memilih overwrite, pengaturan pada layanan akan mencocokkan pengaturan Anda saat ini persis.

MERGE

Menggabungkan pengaturan Anda saat ini dengan pengaturan yang dimodifikasi dari layanan dan memberi Anda kesempatan untuk membuat perubahan sebelum menyelesaikan operasi sinkronisasi.

Jika Anda mengedit nilai pengaturan yang sama, perubahan Anda menulis versi dari layanan. Selain itu, nilai dan pengaturan yang dihapus pada layanan dipulihkan (sejak mereka masih ada dalam versi Anda). Jika tidak, perubahan dari layanan karena Anda tetap disinkronkan.

Setelah merging, halaman Pengaturan Jarak Jauh Anda diperbarui untuk mencerminkan merger, tetapi pengaturan gabungan tidak didorong ke server. Anda dapat meninjau perubahan terbaru dan klik tombol Sync lagi ketika Anda siap.

CANCEL

Membatalkan operasi sinkronisasi dan menutup dialog konflik tanpa membuat perubahan. Pengaturan Anda tidak disimpan ke layanan.

Menambahkan nilai yang berbeda untuk segmen yang berbeda

Anda dapat menetapkan beberapa nilai tersegmentasi ke kunci Pengaturan Jarak Jauh tunggal. Ketika seorang pemain adalah anggota salah satu segmen yang memiliki nilai tertentu, Unity mengirimkan nilai itu kepada pemain bukan nilai default, All Users. (Jika pemain memenuhi syarat untuk beberapa nilai tersegmentasi, Unity mengirimkan nilai dari segmen prioritas tertinggi.)

Untuk menetapkan nilai tertentu ke segmen tertentu:

1. Buka halaman Remote Settings di dasbor Analytics Anda.

2. Pilih Konfigurasi Release atau Development.

3. Tambahkan Pengaturan Jarak Jauh jika tidak ada.

4. Klik ikon edit di sebelah kanan pengaturan.

5. Klik ADD EXISTING SEGMENT.

6. Dalam baris baru, pilih segmen dari daftar drop-down dan masukkan nilai.

7. Klik tombol Save.

Pengaturan Jarak Jauh

Untuk menghapus Pengaturan Jarak Jauh, pertama buka tampilan edit untuk pengaturan:

1. Buka halaman Remote Settings di dasbor Analytics Anda.

2. Mengatur Configuration ke Release atau Development untuk pengaturan.

3. Klik ikon edit di sebelah pengaturan yang ingin dihapus untuk membuka tampilan edit:

   

4. Untuk menghapus nilai untuk segmen tertentu, klik tombol minus ke kanan tampilan edit dan kemudian klik Save. (Anda tidak dapat menghapus nilai All Users default.)

5. Untuk menghapus seluruh pengaturan, klik ikon menghapus di bagian bawah tampilan edit dan kemudian pastikan Anda ingin menghapus pengaturan.

6. Klik tombol Sync untuk menerbitkan perubahan Anda.

Pengaturan prioritas segmen

Ketika pemain adalah anggota lebih dari satu segmen, Unity mengirimkan nilai yang ditetapkan untuk segmen prioritas tertinggi. (Jika pengaturan tidak memiliki nilai tersegmentasi, atau pemain tidak menjadi anggota segmen yang memiliki nilai yang berbeda untuk kunci, maka Unity mengirimkan nilai Semua Pengguna.) Anda dapat mengatur urutan segmen Anda untuk menentukan nilai-nilai yang tersegmentasi harus mengambil precedence ketika ada tumpang tindih.

Untuk mengatur prioritas segmen:

1. Buka halaman Remote Settings di dasbor Analytics Anda.

2. Pilih Konfigurasi Release atau Development.

3. Klik ikon menu di sudut kanan atas daftar pengaturan:

   

4. Klik ikon prioritas segmen.

   

5. Jendela Segment Priority terbuka, menunjukkan pesanan Anda saat ini. Hanya segmen yang sudah ditugaskan nilai untuk Pengaturan Jarak Jauh yang muncul di jendela.

6. Reorder segmen dengan mengklik dan menyeret item ke tempat.

   

7. Ketika pesanan benar, klik Save.

8. Klik tombol Sync untuk menerbitkan perubahan Anda.

Prioritas segmen berlaku untuk semua pengaturan dalam konfigurasi, tetapi Anda dapat memiliki prioritas yang berbeda untuk konfigurasi Pengembangan dan Rilis.

Pengaturan impor dan ekspor

Anda dapat mengimpor dan mengekspor pengaturan menggunakan comma-separated-value (CSV) format file.

To export your current settings:

1. Navigasi ke halaman Pengaturan Jarak Jauh di dasbor Unity AnalyticsSebuah platform data yang menyediakan analitik untuk permainan Unity Anda. More info
   Lihat di Glossary Anda.

2. Pilih konfigurasi, baik Release atau Development yang ingin Anda ekspor.

3. Klik ikon menu di sisi kanan header daftar:

   

4. Pilih Download CSV untuk mengekspor pengaturan saat ini ke komputer Anda.

Layanan Analytics mengunduh pengaturan saat ini sebagai file CSV.

Perhatikan bahwa jika Anda mengunduh file CSV sebelum membuat pengaturan, file benar-benar kosong. File yang valid untuk mengunggah harus berisi baris header. SitemapRemote Pengaturan CSV Login.

To import settings into your project:

1. Navigasi ke halaman Pengaturan Jarak Jauh di dasbor Analisis Unity Anda.

2. Pilih konfigurasi, baik Release atau Development yang ingin Anda tujukan dengan pengaturan impor.

3. Klik ikon menu di sisi kanan header daftar.

4. Pilih Upload CSV untuk mengimpor file pengaturan baru ke proyek.

5. Pilih file CSV yang berisi pengaturan baru.

6. Klik Open.

   Layanan Analytics meng-upload file pengaturan dan menggantikan semua pengaturan saat ini dalam konfigurasi yang dipilih, tetapi tidak melakukan nilai-nilai belum.

   Jika format atau kesalahan nilai ada dalam file, layanan memberi Anda opsi untuk mengunduh file CSV merinci kesalahan. Tidak ada perubahan yang dilakukan pada pengaturan ketika kesalahan terjadi.

7. Klik Sync untuk melakukan perubahan pengaturan dan membuat mereka hidup. (Harap halaman atau arahkan tanpa sinkronisasi untuk membuang pengaturan yang diunggah.)

Ketika Anda mengimpor pengaturan, ALL kunci dan nilai diubah untuk mencocokkan file yang diunggah. Jika pengaturan yang ada atau nilai segmen tidak muncul dalam file, yang pengaturan dihapus.

Membuat dan menghapus pengaturan selama impor

Selain mengedit nilai pengaturan, Anda dapat membuat dan menghapus pengaturan ketika Anda mengunggah file CSV untuk konfigurasi.

Pertama, unduh file CSV pengaturan saat ini untuk konfigurasi. Anda kemudian dapat mengedit file ini untuk membuat perubahan Anda. (Lihat Bekerja dengan Spreadsheet) jika Anda menggunakan aplikasi Spreadsheet untuk mengedit file.)

To create a new setting:

1. Tambahkan baris baru dalam file.
2. Tentukan nama kunci yang unik.
3. Tentukan jenis data (int, float, string, atau bool).
4. Masukkan “Semua Pengguna Saat Ini” sebagai segmen.
5. Tinggalkan blank field terakhir (untuk segmen default).

Pengaturan baru akan terlihat seperti:

a_bool_value,bool,TRUE,All Current Users,

To add a new segmented value for a setting:

1. Tambahkan baris ke file.

2. Ulangi nama kunci dan jenis data dari pengaturan.

3. Masukkan nilai untuk segmen.

4. Masukkan nama segmen. Nama segmen harus didefinisikan untuk proyek sebelum Anda mengimpor pengaturan. Gunakan halaman Pembuat Segmen untuk melihat segmen yang ada serta mendefinisikan yang baru.

5. Mengatur prioritas segmen.

   Prioritas untuk semua segmen dalam file harus menjadi bilangan bulat berturut-turut dimulai dengan 1. Misalnya, jika Anda menggunakan lima segmen dalam file CSV Anda, satu-satunya prioritas yang diperbolehkan adalah angka 1-5. Prioritas yang sama harus ditugaskan di mana pun dalam file yang digunakan. Misalnya, jika Anda menggunakan segmen Jepang untuk nilai puluhan dalam file CSV Anda, nilai prioritas yang sama harus digunakan dalam setiap baris.

Pengaturan dengan nilai tersegmentasi akan terlihat seperti:

a_bool_value,bool,false,All Current Users,
a_bool_value,bool,true,1-3 Days,1
a_bool_value,bool,false,4-7 Days,2

To delete a setting:

Sederhana menghapus baris mendefinisikan pengaturan dari file. Jika Anda menghapus baris yang mengandung default, "Semua Pengguna Saat Ini" segmen, Anda juga harus menghapus setiap baris mendefinisikan nilai-nilai tersegmentasi. Perhatikan bahwa jika Anda menghapus nilai-nilai tersegmentasi yang mungkin juga perlu menerima prioritas segmen untuk mempertahankan urutan integer berturut-turut.

Akhirnya, unggah file CSV yang dimodifikasi dan tekan tombol Sync di halaman Pengaturan Jarak Jauh untuk menyimpan perubahan dan menerbitkan perubahan.

Remote Pengaturan CSV File Format

Format CSV Pengaturan Jarak Jauh sesuai dengan ISO9001-2008,ROHS. File yang diekspor dikodekan sebagai UTF-8.

File pengaturan memiliki lima bidang. Anda harus menyertakan baris header sebagai baris pertama dalam file:

key,type,value,segment,priority

Bidang dalam file adalah:

• key - Nama kunci Pengaturan Jarak Jauh.
• type - jenis data pengaturan: int, float, string, atau bool.
• value - nilai pengaturan.
• segmentSegmen adalah subset dari basis pemain Anda, terpisahkan oleh perbedaan utama. Melihat metrik dan peristiwa oleh segmen dapat mengungkapkan perbedaan perilaku dalam game antara kelompok yang berbeda. More info
  Lihat di Glossary - nama segmen untuk nilai pengaturan.
• priority - prioritas segmen untuk nilai pengaturan.

Rules for entries in the CSV file:

• Setiap baris harus mengandung kombinasi kunci dan segmen yang unik.

• Semua segmen dalam file CSV harus ada. Segmen baru harus dibuat menggunakan halaman Pembuat Segmen dari dashboard Analytics.

• Gunakan string, “Semua Pengguna Saat Ini” untuk segmen default.

• Default "Semua Pengguna Saat Ini" segmen harus dikaitkan dengan setiap kunci persis sekali dalam file.

• Jangan menetapkan prioritas pada segmen “Semua Pengguna Saat Ini” (memiliki garis kosong).

• Prioritas untuk semua segmen lain harus ditugaskan.

• Prioritas segmen harus sama untuk semua kunci yang digunakan dalam.

• Prioritas segmen yang ditugaskan di semua segmen harus berurutan (mulai dengan 1).

• Gunakan TRUE dan FALSE untuk nilai Boolean.

• String yang mengandung kommas, kutipan ganda, dan garis istirahat harus ditutupi dengan karakter ganda-quote.

• Karakter kutipan ganda dalam string harus melarikan diri dengan mengulangi kutipan ganda. Contoh:

  "Hello World!"            -> """Hello World!"""
  He said, "How do you do?" -> "He said, ""How do you do?"""
  

• File dapat berisi hingga 201 baris (termasuk header).

Sitemap Buat sampel Nilai Pengaturan Jarak Jauh di dashboard dan unduh untuk menghasilkan file sampel.Tip: Create sample Remote Settings values on the dashboard and download to generate a sample file.

Bekerja dengan Spreadsheet

Format file CSV tidak secara ketat standar, sehingga Anda mungkin mengalami variasi saat membuka atau menyimpan file CSV dalam aplikasi spreadsheet yang berbeda. Selalu uji bahwa ladang di file Pengaturan Jarak Jauh Anda benar dipertahankan setelah membuat perjalanan pulang dari halaman Pengaturan Jarak Jauh, ke aplikasi pengeditan Anda, dan kembali. Terutama periksa bahwa karakter Unicode (Emoji, simbol, karakter di luar kisaran ASCII dasar, dll) tidak diubah dan angka titik mengambang tidak terpotong.

Biasanya ketika mengimpor file CSV, aplikasi spreadsheet menafsirkan string mulai dengan ', +, -, atau karakter = sebagai ekspresi daripada string polos. Anda dapat mencoba mendorong string seperti dalam kutipan ganda dan menyesuaikan opsi impor spreadsheet yang Anda gunakan. Sebagai contoh, dalam Google Sheets Anda dapat mematikan opsi “Convert string ke nomor dan tanggal”; sementara di LibreOffice Anda dapat menyala, “Quoted Strings Sebagai Teks”.

Untuk pengaturan jenis float, pastikan bahwa semua digit signifikan dari nilai pengaturan ditampilkan dalam sel spreadsheet. Jika tidak, aplikasi spreadsheet truncate nilai dan Anda kehilangan presisi ketika Anda mengekspor spreadsheet ke file CSV.

---

• 2017-12-12 Login

• 2017–08–28 - Layanan yang kompatibel dengan Unity 5.5 seterusnya pada tanggal ini tetapi kompatibilitas versi dapat dikenakan perubahan.

• 2017–06-30 - Ditambahkan: Memungkinkan karakter “.”, “_”, dan “-” dalam nama kunci.

• 2017-06-30 - Ditambahkan: impor CSV dan ekspor.

• Fitur baru di 2017. 1 Artikel

• 2017–08–28 - Ditambahkan Pengaturan Jarak Jauh yang tersegmentasi: menetapkan nilai yang berbeda untuk segmen yang berbeda pada 2017. 1 Artikel