| Important: Dokumentasi Pengiriman Konten Cloud Unity telah pindah ke . Silakan kunjungi situs baru untuk informasi terbaru tentang CCD Unity. |
Bagian ini berisi contoh penuh tentang cara menggunakan Pengiriman Konten Cloud (CCD) melalui antarmuka baris perintah (CLI), termasuk topik berikut:
Masuk ke layanan menggunakan kunci API Anda. Lihat bagian Getting started jika Anda memerlukan bantuan locating kunci API Anda.
$ ucd auth login XXXXXXXXXXXX
Login successful.
Verifikasi apakah Anda login dengan perintah auth info.
$ ucd auth info
Current user: Joe Smith
Buat ember pertama Anda. Bucket dikaitkan dengan satu proyek. ID Proyek untuk contoh ini adalah e1942cea-12df-4220-aa6d-f8c9c3ab7526, tetapi Anda perlu menggunakan salah satu ID Proyek Anda yang sebenarnya. Lihat bagian Getting started jika Anda memerlukan bantuan untuk menemukan ID Proyek Anda.
Daftar ember (yang harus kosong pada titik ini) untuk proyek ini.
$ ucd buckets list e1942cea-12df-4220-aa6d-f8c9c3ab7526
No buckets found for project.
Buat ember yang disebut example_bucket untuk proyek ini:
$ ucd buckets create e1942cea-12df-4220-aa6d-f8c9c3ab7526 example_bucket
Created bucket: example_bucket (aee9ee5f-fa01-46d3-a293-731d15f066cf)
Nama ember dan entri sensitif kasus.
Untuk melihat ember yang baru dibuat, daftar ember lagi untuk proyek ini:
$ ucd buckets list e1942cea-12df-4220-aa6d-f8c9c3ab7526
Buckets for project (e1942cea-12df-4220-aa6d-f8c9c3ab7526):
- example_bucket (aee9ee5f-fa01-46d3-a293-731d15f066cf)
Untuk memudahkan untuk bekerja dengan membuat entri dan rilis, menyimpan ember yang baru dibuat ke konfigurasi lokal (tidak menyediakannya sebagai parameter ke CLI untuk setiap operasi). Salin GUID ember (bukan namanya) dari pesan pembuatan ember di atas (aee9ee5f-fa01-46d3-a293-731d15f066cf dalam contoh ini):
$ ucd config set bucket aee9ee5f-fa01-46d3-a293-731d15f066cf
Successfully switched to bucket aee9ee5f-fa01-46d3-a293-731d15f066cf.
Currently active project: e1942cea-12df-4220-aa6d-f8c9c3ab7526.
Currently active bucket: aee9ee5f-fa01-46d3-a293-731d15f066cf (example_bucket).
CCD secara otomatis melakukan perintah apa pun yang berkaitan dengan entri dan rilis pada ember yang Anda tentukan.
Daftar entri di ember baru diciptakan ini (harusnya kosong):
$ ucd entries list
No Entries found for current bucket.
Sinkronisasikan semua file dalam folder lokal yang mengandung Aset yang dihasilkan:
$ ucd entries sync ./ServerData/StandaloneOSX
Calculating...
Added Entry: catalog_2019.07.30.18.24.34.hash
Added Entry: catalog_2019.07.30.18.24.34.json
Added Entry: remotedemodata_green.bundle
Added Entry: remotedemodata_mat1.bundle
Added Entry: remotedemodata_sphere.bundle
Added Entry: remotedemodata_unitylogo.bundle
Added Entry: remotedemodata_unitylogoprefab.bundle
Added Entry: remotedemodata_scenes_scene2.bundle
Added Entry: remotedemodata_scenes_scene.bundle
Added Entry: spaceshooterdata_done_asteroid01.bundle
Added Entry: spaceshooterdata_done_asteroid02.bundle
Added Entry: spaceshooterdata_done_asteroid03.bundle
Added Entry: spaceshooterdata_done_bolt-enemy.bundle
Added Entry: spaceshooterdata_done_bolt.bundle
Added Entry: spaceshooterdata_done_enemyship.bundle
Added Entry: spaceshooterdata_done_player.bundle
Added Entry: spaceshooterdata_engines_enemy.bundle
Added Entry: spaceshooterdata_engines_player.bundle
Added Entry: spaceshooterdata_explosion_asteroid.bundle
Added Entry: spaceshooterdata_explosion_enemy.bundle
Added Entry: spaceshooterdata_explosion_player.bundle
Added Entry: spaceshooterdata_starfield.bundle
Complete! Bytes uploaded: 5346781
Ini menambahkan file sebagai entri ke ember. Anda dapat mencantumkan konten bucket dan melihat beberapa informasi dasar tentang setiap entri:
$ ucd entries list
22 entries for current bucket (aee9ee5f-fa01-46d3-a293-731d15f066cf):
2019-08-21 14:27:03 167915 spaceshooterdata_starfield.bundle
2019-08-21 14:27:00 573539 spaceshooterdata_explosion_player.bundle
2019-08-21 14:26:56 412235 spaceshooterdata_explosion_enemy.bundle
2019-08-21 14:26:52 382630 spaceshooterdata_explosion_asteroid.bundle
2019-08-21 14:26:49 177018 spaceshooterdata_engines_player.bundle
2019-08-21 14:26:45 157215 spaceshooterdata_engines_enemy.bundle
2019-08-21 14:26:42 1085518 spaceshooterdata_done_player.bundle
2019-08-21 14:26:38 1070297 spaceshooterdata_done_enemyship.bundle
2019-08-21 14:26:34 27178 spaceshooterdata_done_bolt.bundle
2019-08-21 14:26:31 28362 spaceshooterdata_done_bolt-enemy.bundle
2019-08-21 14:26:28 231658 spaceshooterdata_done_asteroid03.bundle
2019-08-21 14:26:24 221450 spaceshooterdata_done_asteroid02.bundle
2019-08-21 14:26:20 227842 spaceshooterdata_done_asteroid01.bundle
2019-08-21 14:26:17 23016 remotedemodata_scenes_scene.bundle
2019-08-21 14:26:13 23064 remotedemodata_scenes_scene2.bundle
2019-08-21 14:26:10 10568 remotedemodata_unitylogoprefab.bundle
2019-08-21 14:26:07 462522 remotedemodata_unitylogo.bundle
2019-08-21 14:26:03 7864 remotedemodata_sphere.bundle
2019-08-21 14:26:00 6320 remotedemodata_mat1.bundle
2019-08-21 14:25:57 6320 remotedemodata_green.bundle
2019-08-21 14:25:53 44218 catalog_2019.07.30.18.24.34.json
2019-08-21 14:25:50 32 catalog_2019.07.30.18.24.34.hash
Untuk mendapatkan informasi lebih rinci tentang entri tertentu, gunakan perintah entries info dengan jalur entri:
$ ucd entries info spaceshooterdata_starfield.bundle`
Entry Info:
Path: spaceshooterdata_starfield.bundle
Id: 8ac46783-be01-4a47-b23e-74233fc7cc09
Last Modified: 2019-08-21 14:27:03
Content Size: 167915
Content Hash: 4a3ad5b69bd489699d1909e8868a7cb1
Content Type: application/octet-stream
Content Link: …
Labels:
Metadata:
Current Version: aa0304db-fd9f-4772-9549-dfeb44cc6d6f
Klien game Anda sekarang dapat meminta konten untuk file individu di ember menggunakan path yang terkait dengan entri. Buat semua permintaan klien game ke subdomain spesifik proyek Anda pada <project_guid>.client-api.unity3dusercontent.com. URL yang dimulai dengan /client_api/v1/ di jalur permintaan. Tidak ada permintaan klien ini memerlukan otentikasi.
Untuk mendapatkan konten entri, seperti spaceshooterdata_starfield.bundle, dengan path, masukkan:
https://<project_guid>.client-api.unity3dusercontent.com/client_api/v1/buckets/aee9ee5f-fa01-46d3-a293-731d15f066cf/entry_by_path/content/?path=spaceshooterdata_starfield.bundle
Atau untuk mendapatkan konten entri dengan Masuk ID, masukkan:
https://<project_guid>.client-api.unity3dusercontent.com/client_api/v1/buckets/aee9ee5f-fa01-46d3-a293-731d15f066cf/entries/8ac46783-be01-4a47-b23e-74233fc7cc09/content/
Buat rilis dari keadaan entri Anda saat ini:
$ ucd releases create
Created release (#1) in bucket (aee9ee5f-fa01-46d3-a293-731d15f066cf).
Id: 80653663-eb39-45e7-9323-e34b23df0d75
Created: 2019-08-21 14:27:30
...
Ini memungkinkan Anda untuk menggunakan versi yang tepat dari entri tersebut ketika meminta konten, bahkan jika Anda memperbarui atau menghapus entri tersebut nanti.
Untuk mendapatkan informasi lebih rinci tentang rilis, gunakan perintah releases info dan memberikan ID rilis yang Anda buat:
$ ucd releases info 80653663-eb39-45e7-9323-e34b23df0d75
Release #1:
Id: 80653663-eb39-45e7-9323-e34b23df0d75
Created: 2019-08-21 14:27:30
Content Size: 123456
Content Hash: b62343cb3582a7de1286dd3cf23c3592
Notes:
Metadata:
Entries:
- remotedemodata_scenes_scene2.bundle (version: d7c69bc0-5c0b-4625-8a7d-94a4972aa236)
- remotedemodata_unitylogo.bundle (version: 97d3659f-0b74-403a-be67-02641ce2dc91)
- spaceshooterdata_done_enemyship.bundle (version: edcedc81-80b6-4006-9732-0444898fcffa)
- remotedemodata_unitylogoprefab.bundle (version: 4edfa2be-7fae-44c9-bb45-f601cc1130db)
- spaceshooterdata_done_bolt-enemy.bundle (version: ef36bfa8-8b24-4b81-a329-b3fad0a0939b)
...
Untuk mendapatkan daftar semua rilis yang Anda hasilkan dalam ember ini, masukkan:
$ ucd releases list
Releases for current bucket (aee9ee5f-fa01-46d3-a293-731d15f066cf):
2019-08-21 14:27:30 #1 (80653663-eb39-45e7-9323-e34b23df0d75)
Anda sekarang dapat secara langsung merujuk konten yang terkandung dalam rilis ini. Ini memastikan Anda mendapatkan set konten yang tepat yang digunakan CCD untuk menghasilkan rilis bahkan jika Anda mengubah entri nanti dalam ember.
Untuk mendapatkan konten entri, seperti spaceshooterdata_starfield.bundle, dengan path, masukkan:
https://<project_guid>.client-api.unity3dusercontent.com/client_api/v1/buckets/aee9ee5f-fa01-46d3-a293-731d15f066cf/releases/80653663-eb39-45e7-9323-e34b23df0d75/entry_by_path/content/?path=spaceshooterdata_starfield.bundle
Atau untuk mendapatkan konten entri dengan Masuk ID, masukkan:
https://<project_guid>.client-api.unity3dusercontent.com/client_api/v1/buckets/aee9ee5f-fa01-46d3-a293-731d15f066cf/releases/80653663-eb39-45e7-9323-e34b23df0d75/entries/8ac46783-be01-4a47-b23e-74233fc7cc09/content/
Anda juga dapat meminta konten yang sesuai dengan rilis terbaru di ember, sehingga klien tidak perlu mengubah setiap kali CCD menghasilkan rilis baru. Untuk melakukan ini, memperbarui permintaan untuk menggunakan rute release_by_badge dan menentukan nama lencana latest (lihat Mengelola lencana). Contoh:
https://<project_guid>.client-api.unity3dusercontent.com/client_api/v1/buckets/aee9ee5f-fa01-46d3-a293-731d15f066cf/release_by_badge/latest/entry_by_path/content/?path=spaceshooterdata_starfield.bundle
Setelah menghasilkan rilis, Anda dapat menerapkan lencana yang unik mengidentifikasi rilis. Lencana hanya dapat menunjuk ke rilis tunggal dalam ember, tetapi Anda dapat memindahkan lencana antara rilis. Pada runtime, Anda dapat meminta konten menggunakan nama lencana daripada ID rilis tertentu, memungkinkan untuk lebih banyak fleksibilitas dalam alur kerja.
Misalnya, Anda mungkin menerapkan lencana yang disebut qa_latest untuk rilis terbaru untuk tim QA Anda untuk menggunakan, dan memindahkan lencana ke setiap rilis baru sebagai bagian dari proses (manual atau otomatis).
Untuk menambahkan lencana bernama my_first_badge untuk rilis yang Anda hasilkan dalam Membuat rilis, masukkan:
$ ucd badges add my_first_badge 80653663-eb39-45e7-9323-e34b23df0d75
Added badge 'my_first_badge' to release (80653663-eb39-45e7-9323-e34b23df0d75).
Untuk mencantumkan semua lencana Anda diterapkan di ember ini:
$ ucd badges list
Badges for current bucket (aee9ee5f-fa01-46d3-a293-731d15f066cf):
2020-01-07 12:55:41 my_first_badge (80653663-eb39-45e7-9323-e34b23df0d75)
Konten yang terkait dengan rilis bahwa referensi lencana siap untuk diunduh. Anda dapat melakukan ini dengan cara yang sama untuk mengunduh konten langsung dengan Masuk ID.
Untuk mendapatkan konten untuk masuk, seperti spaceshooterdata_starfield.bundle, dengan path, masukkan:
https://<project_guid>.client-api.unity3dusercontent.com/client_api/v1/buckets/aee9ee5f-fa01-46d3-a293-731d15f066cf/release_by_badge/my_first_badge/entry_by_path/content/?path=spaceshooterdata_starfield.bundle
Atau untuk mendapatkan konten entri dengan Masuk ID, masukkan:
https://<project_guid>.client-api.unity3dusercontent.com/client_api/v1/buckets/aee9ee5f-fa01-46d3-a293-731d15f066cf/release_by_badge/my_first_badge/entries/8ac46783-be01-4a47-b23e-74233fc7cc09/content/