AWS Mobile SDK for Unity sekarang disertakan dalam AWS SDK for .NET. Panduan ini menjadi referensi versi yang diarsipkan dari Mobile SDK for Unity. Untuk informasi selengkapnya, lihat Apa yang dimaksud dengan AWS Mobile SDK for Unity?

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Menyiapkan AWS Mobile SDK for Unity

Untuk memulai AWS Mobile SDK for Unity, Anda dapat menyiapkan SDK dan mulai membangun sebuah proyek baru, atau Anda dapat mengintegrasikan SDK dengan proyek yang ada. Anda juga dapat melakukan klon dan menjalankan Sampel untuk mengetahui cara kerja SDK.

Prasyarat

Sebelum Anda dapat menggunakan AWS Mobile SDK for Unity, Anda akan memerlukan yang berikut ini:

Setelah menyelesaikan prasyarat tersebut, Anda harus melakukan hal-hal berikut untuk memulai:

Langkah 1: Mengunduh AWS Mobile SDK for Unity

Pertama, Mengunduh AWS Mobile SDK for Unity. Setiap paket dalam SDK tersebut diperlukan untuk menggunakan layanan AWS yang sesuai berdasarkan nama paket. Misalnya,aws-unity-sdkpaket -dynamodb-2.1.0.0.unitypackage digunakan untuk memanggil layanan AWS DynamoDB. Anda dapat mengimpor semua paket atau hanya paket yang ingin Anda gunakan.

Langkah 2: Mengonfigurasi AWS Mobile SDK for Unity

Membuat Adegan

Ketika bekerja dengan AWS Mobile SDK for Unity, Anda bisa memulai dengan memasukkan baris kode berikut di metode Start atau Awake kelas perilaku mono Anda:

UnityInitializer.AttachToGameObject(this.gameObject);

Buat adegan Anda dengan memilih Adegan Baru dari halaman menu File.

AWS SDK for Unity berisi kelas klien untuk masing-masing layanan AWS yang di-support-nya. Klien ini dikonfigurasi menggunakan file bernama awsconfig.xml. Bagian berikut menjelaskan pengaturan yang paling umum digunakan di file awsconfig.xml. Untuk informasi lebih lanjut tentang pengaturan ini, lihat Referensi Unity SDK API.

Mengatur Wilayah Layanan AWS Default

Untuk mengonfigurasi wilayah default untuk semua klien layanan:

<aws region="us-west-2" />

Ini akan menetapkan wilayah default untuk semua klien layanan di Unity SDK. Pengaturan ini dapat diganti dengan secara eksplisit menentukan wilayah pada saat membuat sebuah instans dari klien layanan, seperti berikut:

IAmazonS3 s3Client = new AmazonS3Client(<credentials>,RegionEndpoint.USEast1);

Mengatur Informasi Pencatatan

Pengaturan pencatatan ditentukan sebagai berikut:

<logging logTo="UnityLogger"
         logResponses="Always"
         logMetrics="true"
         logMetricsFormat="JSON" />

Pengaturan ini digunakan untuk mengonfigurasi pencatatan di Unity. Saat Anda mencatat catatan ke UnityLogger, kerangka kerja secara internal mencetak keluaran ke Catatan Debug. Jika Anda ingin mencatat tanggapan HTTP, atur bendera logResponses - nilainya bisa Selalu, Tidak Pernah, atauOnError. Anda juga dapat mencatat metrik performa untuk permintaan HTTP dengan menggunakan properti LogMetrics, format catatan dapat ditentukan dengan menggunakanLogMetricsProperti format, nilai yang valid adalah JSON atau standar.

Contoh berikut menunjukkan pengaturan yang paling umum digunakan dalam file awsconfig.xml. Untuk informasi lebih lanjut tentang pengaturan layanan tertentu, lihat bagian layanan di bawah ini:

<?xml version="1.0" encoding="utf-8"?>
<aws region="us-west-2"
    <logging logTo="UnityLogger"
             logResponses="Always"
             logMetrics="true"
             logMetricsFormat="JSON" />
/>

Cara menggunakan file link.xml

SDK tersebut menggunakan refleksi untuk komponen spesifik platform. Jika anda menggunakan backend penulisan IL2CPP, strip bytecode akan selalu diaktifkan di iOS, jadi Anda harus melakukan root atas file link.xml yang ada dalam unit Anda dengan entri berikut:

<linker>
<!-- if you are using AWSConfigs.HttpClient.UnityWebRequest option-->
<assembly fullname="UnityEngine">
    <type fullname="UnityEngine.Networking.UnityWebRequest" preserve="all" />
    <type fullname="UnityEngine.Networking.UploadHandlerRaw" preserve="all" />
    <type fullname="UnityEngine.Networking.UploadHandler" preserve="all" />
    <type fullname="UnityEngine.Networking.DownloadHandler" preserve="all" />
    <type fullname="UnityEngine.Networking.DownloadHandlerBuffer" preserve="all" />
</assembly>
<assembly fullname="mscorlib">
    <namespace fullname="System.Security.Cryptography" preserve="all"/>
</assembly>
<assembly fullname="System">
    <namespace fullname="System.Security.Cryptography" preserve="all"/>
</assembly>
<assembly fullname="AWSSDK.Core" preserve="all"/>
<assembly fullname="AWSSDK.CognitoIdentity" preserve="all"/>
<assembly fullname="AWSSDK.SecurityToken" preserve="all"/>
add more services that you need here...
</linker>

Langkah 3: Mendapatkan ID Kolam Identitas menggunakan Amazon Cognito

Untuk menggunakan layanan AWS dalam aplikasi seluler Anda, Anda harus mendapatkan ID Kolam Identitas menggunakan Identitas Amazon Cognito. Dengan menggunakan Amazon Cognito untuk mendapatkan ID Kolam Identitas akan memungkinkan aplikasi Anda untuk mengakses layanan AWS tanpa harus menanamkan kredensial privat Anda dalam aplikasi Anda. Hal ini juga akan memungkinkan Anda untuk mengatur izin untuk mengendalikan layanan AWS yang bisa diakses pengguna Anda.

Untuk memulai Amazon Cognito, Anda harus membuat kolam identitas. Kolam identitas adalah penyimpanan data identitas pengguna yang spesifik untuk akun Anda. Setiap kolam identitas memiliki IAM role yang dapat dikonfigurasi yang memungkinkan Anda untuk menentukan layanan AWS yang dapat diakses pengguna aplikasi Anda. Biasanya, developer akan menggunakan satu kolam identitas untuk setiap aplikasi. Untuk informasi lebih lanjut tentang kolam identitas, lihat Panduan Developer Amazon Cognito.

Untuk membuat kolam identitas untuk aplikasi Anda:

Halaman berikutnya menampilkan kode yang membuat penyedia kredensial sehingga Anda dapat dengan mudah mengintegrasikan Identitas Cognito dengan aplikasi Unity Anda. Anda memberikan objek penyedia kredensials untuk konstruktor dari klien AWS yang Anda gunakan. Kodenya terlihat seperti ini:

CognitoAWSCredentials credentials = new CognitoAWSCredentials (
    "IDENTITY_POOL_ID", // Identity Pool ID
    RegionEndpoint.USEast1 // Region
);

Langkah Selanjutnya