Fitur perangkat dan izin
Tentukan izin untuk aplikasi

Izin Android dalam Unity

Untuk mendapatkan izin untuk mengakses fitur perangkat atau data di luar kotak pasir aplikasi Unity Anda, ada dua tahap:

  1. Pada waktu membangun, deklarasikan izin pada Android SDK aplikasi.
  2. Pada runtime, meminta izin dari pengguna.

Untuk beberapa izin, Unity secara otomatis menangani entri Manifest Android build-time dan permintaan izin runtime. Untuk informasi lebih lanjut, lihat Izin yang dipasang oleh Unity.

Declare permissions

Aplikasi Android hanya dapat meminta pengguna untuk izin untuk menggunakan fitur perangkat atau data yang dideklarasikan di Android App Manifest. Ini adalah tahap build-time dari penanganan izin Android. Untuk informasi tentang cara menyatakan izin, lihat Tentukan izin untuk aplikasi.

Note: Jika plug-inSatu set kode yang dibuat di luar Unity yang menciptakan fungsi dalam Unity. Ada dua jenis plug-ins yang dapat Anda gunakan di Unity: Managed plug-ins (diproduksi. Rakitan NET dibuat dengan alat-alat seperti Studio Visual) dan plug-ins asli (pustaka kode asli yang spesifik platform). More info
Lihat di Glossary
mendeklarasikan izin dalam Android App Manifest, GradleSistem build Android yang mengotomatiskan beberapa proses build. Otomasi ini berarti bahwa banyak kesalahan build umum cenderung terjadi. More info
Lihat di Glossary
secara otomatis menambahkan izin ke final Android App Manifest selama tahap gabungan Gradle

Runtime permissions

Anda dapat meminta izin runtime kapan saja saat aplikasi berjalan. Praktik terbaik untuk meminta izin untuk membatasi data atau fitur perangkat ketika aplikasi memerlukan data/fitur untuk pertama kalinya. Anda juga harus menunjukkan pengguna pesan yang menjelaskan mengapa aplikasi membutuhkan data/fitur sebelum Anda mengirim permintaan. Hal ini penting untuk memberikan konteks pengguna sehingga mereka kurang mungkin untuk menyangkal izin kebingungan.

Untuk informasi tentang cara meminta izin pada runtime, lihat Permohonan izin runtime.

Important: Jika Anda mencoba meminta pengguna untuk izin bahwa Android App Manifest tidak menyatakan, perangkat tidak menunjukkan dialog izin.

Izin yang dipasang oleh Unity

Tergantung pada API Pengaturan PemainPengaturan yang memungkinkan Anda mengatur berbagai pilihan khusus pemain untuk permainan akhir yang dibangun oleh Unity. More info
Lihat di Glossary
dan Unity yang digunakan aplikasi, Unity secara otomatis menambahkan beberapa izin yang diperlukan untuk Android App Manifest dan mengirimkan permintaan izin pada runtime. Ini juga berlaku untuk setiap plug-ins yang digunakan aplikasi.

Untuk menghentikan Unity dari secara otomatis mengirimkan permintaan izin pada runtime, tambahkan unityplayer.SkipPermissionsDialog ke Android App Manifest. Ini berguna jika Anda ingin memberikan informasi tentang mengapa aplikasi membutuhkan setiap izin sebelum pengguna melihat permintaan izin. Dalam hal ini, Anda perlu mengirim permintaan izin secara manual. Untuk informasi lebih lanjut, lihat Permohonan izin runtime.

Daftar berikut menjelaskan izin yang ditangani secara otomatis:

  • Jika aplikasi menggunakan kelas Network, Unity menambahkan izin INTERNET ke Android App Manifest dan meminta izin dari pengguna pertama kalinya bahwa aplikasi menggunakan Network.
  • Jika aplikasi menggunakan getaran seperti Login Login, Unity menambahkan izin VIBRATE ke Android App Manifest dan meminta izin dari pengguna pertama kalinya bahwa aplikasi menggunakan getaran.
  • Jika aplikasi menggunakan properti InternetReachability, Unity menambahkan izin ACCESS_NETWORK_STATE ke Android App Manifest dan meminta izin dari pengguna pertama kalinya bahwa aplikasi menggunakan Application.InternetReachability.
  • Jika aplikasi menggunakan API lokasi seperti LocationService, Unity menambahkan izin ACCESS_FINE_LOCATION ke Android App Manifest dan meminta izin dari pengguna pertama kalinya bahwa aplikasi menggunakan lokasi.
  • Jika aplikasi menggunakan Unity kelas WebCamTexture menambahkan izin CAMERA ke Android App Manifest dan meminta izin dari pengguna pertama kalinya bahwa aplikasi menggunakan WebCamTexture.
  • Jika aplikasi menggunakan kelas Mikrofon menambahkan izin RECORD_AUDIO ke Android App Manifest dan meminta izin dari pengguna pertama kalinya bahwa aplikasi menggunakan Microphone.

Sumber daya tambahan

Fitur perangkat dan izin
Tentukan izin untuk aplikasi