AWS Mobile SDK for Unity sekarang disertakan dalam AWS SDK untuk .NET. Panduan ini menjadi referensi versi yang diarsipkan dari Mobile SDK for Unity. Untuk informasi selengkapnya, lihat [Apa itu SDK for Unity AWS Seluler?](what-is-unity-plugin.md)

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
<a name="setup-unity"></a>

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](https://github.com/awslabs/aws-sdk-unity-samples) untuk mengetahui cara kerja SDK.

## Prasyarat
<a name="prerequisites"></a>

Sebelum Anda dapat menggunakan AWS Mobile SDK for Unity, Anda akan memerlukan yang berikut ini:
+  [Akun AWS](https://aws.amazon.com/) 
+ Unity versi 4.x atau 5.x (Unity 4.6.4p4 atau Unity 5.0.1p3 diperlukan jika Anda ingin tulis aplikasi yang berjalan di iOS 64-bit)

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

1. Mengunduh AWS Mobile SDK for Unity.

1. Mengonfigurasi AWS Mobile SDK for Unity.

1. Mendapatkan kredensial AWS dengan menggunakan Amazon Cognito.

## Langkah 1: Mengunduh AWS Mobile SDK for Unity
<a name="step-1-download-the-aws-mobile-sdk-for-unity"></a>

Pertama, [Mengunduh AWS Mobile SDK for Unity](http://sdk-for-net.amazonwebservices.com/latest/aws-sdk-unity.zip). Setiap paket dalam SDK tersebut diperlukan untuk menggunakan layanan AWS yang sesuai berdasarkan nama paket. Misalnya, paket aws-unity-sdk-dynamodb -2.1.0.0.unitypackage digunakan untuk memanggil layanan AWS DynamoDB. Anda dapat mengimpor semua paket atau hanya paket yang ingin Anda gunakan.

1. Buka editor Unity dan buat proyek kosong baru, gunakan pengaturan default.

1. Pilih **Aset** > **Paket Impor** > **Paket Kustom**.

1. Di dialog paket **Impor**, arahkan ke dan pilih file .unitypackage yang ingin Anda gunakan.

1. Di dialog paket **Mengimpor**, pastikan semua item dipilih dan klik **Impor**.

## Langkah 2: Mengonfigurasi AWS Mobile SDK for Unity
<a name="step-2-configure-the-aws-mobile-sdk-for-unity"></a>

### Membuat Adegan
<a name="create-a-scene"></a>

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](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/Index.html).

### Mengatur Wilayah Layanan AWS Default
<a name="set-the-default-aws-service-region"></a>

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
<a name="set-logging-information"></a>

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 respons HTTP, atur tanda logreSponses - nilainya bisa Selalu, Tidak Pernah, atau. OnError Anda juga dapat mencatat metrik kinerja untuk permintaan HTTP menggunakan properti LogMetrics, format log dapat ditentukan LogMetricsFormat menggunakan properti, 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
<a name="working-with-the-link-xml-file"></a>

SDK tersebut menggunakan refleksi untuk komponen spesifik platform. Jika Anda menggunakan backend skrip IL2 CPP, selalu `strip bytecode` diaktifkan di iOS, jadi Anda harus memiliki `link.xml` file di root assembly 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
<a name="step-3-obtain-the-identity-pool-id-using-amazon-cognito"></a>

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](https://docs.aws.amazon.com/cognito/latest/developerguide/identity-pools.html).

Untuk membuat kolam identitas untuk aplikasi Anda:

1. Masuk ke [Konsol Amazon Cognito](https://console.aws.amazon.com/cognito/home) dan klik **Membuat kolam identitas baru**.

1. Masukkan nama untuk Kolam Identitas Anda dan beri tanda periksa pada kotak centang untuk mengaktifkan akses ke identitas yang tidak di-autentikasi. Klik **Buat Kolam** untuk membuat kolam identitas Anda.

1. Klik **Izinkan** untuk membuat dua peran default yang yang ter-associate dengan kolam identitas Anda—satu untuk pengguna yang tidak di-autentikasi dan satu untuk pengguna yang di-autentikasi. Peran default ini memberikan akses kolam identitas Anda ke Cognito Sync dan Mobile Analytics.

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 Berikutnya
<a name="next-steps"></a>
+  **Memulai**: Baca [Memulai AWS Mobile SDK for Unity](getting-started-unity.md) untuk mendapatkan gambaran umum yang lebih detail tentang layanan yang disertakan dalam SDK.
+  **Jalankan demo**: Lihat [Aplikasi Unity sampel](https://github.com/awslabs/aws-sdk-unity-samples) kami yang menunjukkan kasus penggunaan umum. Untuk menjalankan aplikasi sampel, lakukan pengaturan atas SDK for Unity seperti yang dijelaskan di atas, dan kemudian ikuti petunjuk yang terdapat dalam file README dari setiap sampel.
+  **Baca Referensi API**: Lihat [Referensi API](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/Index.html) untuk AWS Mobile SDK for Unity.
+  **Ajukan pertanyaan**: Posting pertanyaan di [Forum AWS Mobile SDK](https://forums.aws.amazon.com/forum.jspa?forumID=88) atau [buka masalah di Github](https://github.com/aws/aws-sdk-unity/issues).