Kontrol yang diperluas, setelan, dan bantuan

Gunakan kontrol yang diperluas di Android Emulator untuk mengirim data, mengubah properti perangkat, mengontrol aplikasi, dan banyak lagi. Untuk membuka jendela Extended controls, klik More Ikon kontrol Emulator yang diperluas di panel emulator. Perhatikan bahwa beberapa opsi kontrol yang diperluas ini hanya tersedia saat Anda menjalankan emulator di jendela terpisah di luar Android Studio.

Anda dapat menggunakan pintasan keyboard untuk melakukan berbagai tugas ini. Untuk mengetahui daftar lengkap pintasan di emulator, tekan F1 (Command+/ di macOS) untuk membuka panel Bantuan.

Tabel 1. Detail kontrol yang diperluas

Fitur Deskripsi
Lokasi

Emulator memungkinkan Anda menyimulasikan informasi "my location": tempat perangkat yang diemulasikan berada. Misalnya, jika Anda mengklik Lokasi Saya Ikon Lokasi Saya di Google Maps, lalu mengirimkan lokasi, peta akan menampilkannya.

Kontrol untuk informasi lokasi perangkat disusun dalam dua tab: Single points dan Routes.

Poin tunggal

Di tab Single points, Anda dapat menggunakan webview Google Maps untuk menelusuri lokasi menarik, sama seperti yang Anda lakukan saat menggunakan Google Maps di ponsel atau di browser. Saat menelusuri (atau mengklik) lokasi di peta, Anda dapat menyimpan lokasi dengan memilih Save point di dekat bagian bawah peta. Semua lokasi yang disimpan tercantum di sisi kanan jendela Extended controls.

Untuk menetapkan lokasi emulator ke lokasi yang Anda pilih di peta, klik tombol Set location di dekat bagian kanan bawah jendela Extended controls.

Rute

Serupa dengan tab Single points, tab Routes juga memberikan webview Google Maps yang dapat Anda gunakan untuk membuat rute antara dua atau beberapa lokasi. Untuk membuat dan menyimpan rute, lakukan langkah berikut:

  1. Dalam tampilan peta, gunakan kolom teks untuk menelusuri tujuan pertama dalam rute Anda.
  2. Pilih lokasi dari hasil penelusuran.
  3. Pilih tombol Navigate .
  4. Pilih titik awal rute Anda dari peta.
  5. (Opsional) Klik Add destination untuk menambahkan lebih banyak perhentian ke rute Anda.
  6. Simpan rute dengan mengklik Save route di tampilan peta.
  7. Tentukan nama untuk rute dan klik Save.

Untuk menyimulasikan Emulator yang mengikuti rute yang Anda simpan, pilih rute dari daftar Saved routes dan klik Play route di dekat kanan bawah jendela Extended controls. Untuk menghentikan simulasi, klik Stop route.

Untuk terus menyimulasikan emulator mengikuti rute yang ditentukan, aktifkan tombol di sebelah Repeat playback. Untuk mengubah seberapa cepat emulator mengikuti rute yang ditentukan, pilih opsi dari menu Playback speed.

Mengimpor data GPX dan KML

Untuk menggunakan data geografis dari format file GPS exchange (GPX) atau Keyhole Markup Language (KML):

  1. Klik Load GPX/KML.
  2. Dalam kotak dialog file, pilih file di komputer Anda dan klik Open.
  3. Secara opsional, pilih Speed.
  4. Kecepatan ditetapkan secara default ke nilai Delay (Speed 1X). Anda dapat meningkatkan kecepatan dua kali lipat (Speed 2X), tiga kali lipat (Speed 3X), dan seterusnya.

  5. Klik Run Ikon Run.
Layar

Emulator memungkinkan Anda men-deploy aplikasi ke beberapa tampilan, yang mendukung dimensi kustom serta dapat membantu Anda menguji aplikasi yang mendukung multi-jendela dan multi-tampilan. Saat perangkat virtual sedang berjalan, Anda dapat menambahkan hingga dua tampilan tambahan seperti berikut:

  1. Tambahkan tampilan dengan mengklik Add secondary display.
  2. Dari menu di bagian Secondary displays, lakukan salah satu langkah berikut:
    1. Pilih salah satu rasio aspek yang telah ditetapkan sebelumnya.
    2. Pilih custom, lalu tetapkan height, width, serta dpi untuk tampilan kustom.
  3. (Opsional) Klik Add secondary display untuk menambahkan tampilan ketiga.
  4. Klik Apply changes untuk menambahkan tampilan yang ditentukan ke perangkat virtual yang sedang berjalan.
Seluler

Emulator memungkinkan Anda menyimulasikan berbagai kondisi jaringan. Anda dapat memperkirakan kecepatan jaringan untuk berbagai protokol jaringan, atau menetapkan Full, yang akan mentransfer data secepat yang dimungkinkan komputer Anda. Kecepatan protokol jaringan yang ditetapkan akan selalu lebih lambat daripada Full. Anda juga dapat menetapkan status jaringan data dan suara, seperti roaming. Nilai default diatur dalam AVD.

Pilih Network type:

  • GSM: Global System for Mobile Communications
  • HSCSD: Data yang Dialihkan Sirkuit Berkecepatan Tinggi
  • GPRS: Generic Packet Radio Service
  • EDGE: Kecepatan Data yang Ditingkatkan untuk GSM Evolution
  • UMTS: Universal Mobile Telecommunication System (Sistem Telekomunikasi Seluler Universal)
  • HSPDA: Akses Paket Downlink Kecepatan Tinggi
  • LTE: Evolusi Jangka Panjang
  • Full (default): Menggunakan jaringan yang disediakan oleh komputer Anda

Pilih Signal strength:

  • None
  • Buruk
  • Moderate (default)
  • Baik
  • Sangat baik

Pilih Voice status, Data status, atau keduanya:

  • Home (default)
  • Jelajah
  • Menelusuri
  • Ditolak (khusus panggilan darurat)
  • Tidak terdaftar (nonaktif)
Baterai

Anda dapat membuat simulasi properti baterai di perangkat untuk melihat cara kerja aplikasi Anda dalam kondisi yang berbeda. Untuk memilih Charge level, gunakan kontrol penggeser.

Pilih nilai Charger connection:

  • None
  • AC charger

Pilih nilai Battery health:

  • Good (default)
  • Gagal
  • Mati
  • Voltase berlebih
  • Terlalu panas
  • Tidak diketahui

Pilih nilai Battery status:

  • Tidak diketahui
  • Charging (default)
  • Pengeluaran
  • Tidak mengisi daya
  • Penuh
Kamera Anda dapat memuat gambar ke dalam adegan yang disimulasikan saat membuka kamera emulator. Untuk mengetahui informasi selengkapnya, baca Menambahkan Gambar Augmented ke adegan dalam dokumentasi ARCore.
Ponsel

Emulator memungkinkan Anda melakukan simulasi panggilan ponsel masuk dan SMS.

Untuk memulai panggilan ke emulator:

  1. Pilih atau ketik nomor ponsel di kolom From.
  2. Klik Call Device.
  3. Anda juga dapat mengklik Hold Call untuk menahan panggilan.
  4. Untuk mengakhiri panggilan, klik End Call.

Untuk mengirim SMS ke emulator:

  1. Pilih atau ketik nomor ponsel di kolom From.
  2. Ketik pesan di kolom SMS message.
  3. Klik Send Message.
Tombol Arah

Jika AVD memiliki tombol arah yang diaktifkan dalam profil hardware, Anda dapat menggunakan kontrol tombol arah dengan emulator. Namun, tidak semua perangkat mendukung tombol arah; misalnya, smartwatch Android tidak mendukung ini. Tombol-tombol tersebut akan menyimulasikan tindakan berikut:

Kontrol Directional Pad
Mikrofon Jika opsi Virtual microphone uses host audio input diaktifkan, emulator akan menerima input audio dari mikrofon host. Jika tidak, emulator tidak akan menerima input audio apa pun. Opsi Virtual headset plug inserted, Virtual headset has microphone, dan Bantuan Suara saat ini tidak diterapkan.
Sidik jari

Kontrol ini dapat menyimulasikan 10 pemindaian sidik jari yang berbeda. Anda dapat menggunakannya untuk menguji integrasi sidik jari di aplikasi Anda. Fitur ini dinonaktifkan untuk Android 5.1 (API level 22) dan versi lebih rendah, serta untuk Wear OS.

Untuk menyimulasikan pemindaian sidik jari di perangkat virtual:

  1. Persiapkan sebuah aplikasi untuk menerima sidik jari.
  2. Pilih nilai Fingerprint.
  3. Klik Touch Sensor.
Virtual sensors > Device Pose

Kontrol ini memungkinkan Anda menguji aplikasi terhadap perubahan posisi perangkat, orientasi, atau keduanya. Misalnya, Anda dapat melakukan simulasi gerakan seperti kemiringan dan rotasi. Akselerometer tidak melacak posisi mutlak perangkat: akselerator hanya mendeteksi adanya perubahan. Kontrol ini melakukan simulasi cara sensor akselerometer dan magnetometer merespons saat Anda memindahkan atau memutar perangkat sungguhan.

Anda harus mengaktifkan sensor akselerometer di AVD agar dapat menggunakan kontrol ini.

Kontrol tersebut melaporkan peristiwa TYPE_ACCELEROMETER pada sumbu x, y, dan z. Nilai-nilai ini meliputi gravitasi. Misalnya, jika tertahan di luar angkasa, perangkat akan mengalami percepatan nol (semua x, y, dan z menjadi 0). Saat perangkat berada di Bumi, di atas meja dengan layar menghadap ke atas, percepatannya adalah 0, 0, dan 9,8 karena adanya gravitasi.

Kontrol tersebut juga melaporkan peristiwa TYPE_MAGNETIC_FIELD, yang mengukur medan magnet sekitar pada sumbu x, y, dan z dalam mikrotesla (μT).

Untuk memutar perangkat terhadap sumbu x, y, dan z, pilih Rotate dan lakukan salah satu langkah berikut:

  • Sesuaikan penggeser Yaw, Pitch, dan Roll lalu amati posisinya di panel atas.
  • Pindahkan representasi perangkat di panel atas, lalu amati Yaw, Pitch, dan Roll serta perubahan nilai akselerometer yang dihasilkan.

Baca Menghitung orientasi perangkat untuk mengetahui informasi selengkapnya tentang penghitungan yaw, pitch, dan roll.

Untuk memindahkan perangkat secara horizontal (x) atau vertikal (y), pilih Move dan lakukan salah satu langkah berikut:

  • Sesuaikan penggeser X dan Y, lalu amati posisinya di panel atas.
  • Pindahkan representasi perangkat di panel atas, lalu amati nilai penggeser X dan Y, serta bagaimana nilai akselerometer yang dihasilkan berubah.

Untuk memosisikan perangkat pada sudut 0, 90, 180, atau 270 derajat:

  • Di area Device rotation, pilih tombol untuk mengubah rotasi.

Saat Anda menyesuaikan perangkat, kolom Resulting values akan ikut berubah. Ini adalah nilai yang dapat diakses oleh aplikasi.

Untuk mengetahui informasi selengkapnya tentang sensor ini, lihat Ringkasan sensor, Sensor gerakan, dan Sensor posisi.

Sensor virtual > Sensor tambahan

Emulator dapat melakukan simulasi berbagai sensor posisi dan lingkungan. Hal ini memungkinkan Anda untuk menyesuaikan sensor berikut sehingga Anda dapat mengujinya dengan aplikasi:

  • Ambient temperature: Sensor lingkungan ini mengukur suhu udara sekitar.
  • Magnetic field: Sensor posisi ini mengukur medan magnet sekitar pada sumbu X, Y, dan Z. Nilainya dinyatakan dalam mikrotesla (μT).
  • Proximity: Sensor posisi ini mengukur jarak dari suatu objek; misalnya, sensor ini dapat memberi tahu telepon bahwa ada wajah yang dekat dengannya untuk melakukan panggilan. Sensor kedekatan harus diaktifkan di AVD untuk menggunakan kontrol ini.
  • Light: Sensor lingkungan ini mengukur pencahayaan. Nilainya dinyatakan dalam satuan lux.
  • Pressure: Sensor lingkungan ini mengukur tekanan udara sekitar. Nilainya dinyatakan dalam satuan milibar (hPa).
  • Relative Humidity: Sensor lingkungan ini mengukur kelembaban relatif sekitar.

Untuk mengetahui informasi selengkapnya tentang sensor ini, baca Ringkasan sensor, Sensor posisi, dan Sensor lingkungan .

Laporan bug Jika mengalami masalah dengan emulator, Anda dapat menyiapkan dan mengirim laporan bug. Emulator secara otomatis akan mengumpulkan screenshot, log, dan data lainnya untuk laporan bug.
Rekam dan Putar Baca Perekaman layar.
Google Play Jika image sistem AVD menyertakan aplikasi Play Store, informasi versi layanan Google Play akan ditampilkan.
Setelan > Umum
  • Emulator window theme: Pilih Light atau Dark.
  • Kirim pintasan keyboard ke: Secara default, beberapa kombinasi keyboard akan memicu pintasan kontrol emulator. Jika mengembangkan aplikasi yang menyertakan pintasan keyboard, seperti yang ditargetkan di perangkat dengan keyboard Bluetooth, Anda dapat mengubah setelan ini agar mengirim semua input keyboard ke perangkat virtual, termasuk input yang akan menjadi pintasan di emulator.
  • Screenshot save location: Klik ikon folder untuk menetapkan lokasi penyimpanan screenshot dari emulator.
  • Use detected ADB location: Jika Anda menjalankan emulator dari Android Studio, pilih setelan ini (default). Jika Anda menjalankan emulator dari luar Android Studio dan ingin menggunakan adb tertentu yang dapat dijalankan, hapus opsi ini dan tetapkan lokasi SDK Tools. Jika setelan ini salah, fitur seperti tangkapan screenshot dan penginstalan aplikasi tarik lalu lepas tidak dapat berfungsi.
  • Kapan harus mengirim laporan error: Pilih Selalu, Tidak Pernah, atau Tanya.
  • Show window frame around device: Secara default, emulator dengan file skin perangkat ditampilkan tanpa frame jendela di sekitarnya.
Setelan > Proxy

Secara default, emulator menggunakan setelan proxy HTTP Android Studio. Layar ini memungkinkan Anda menentukan konfigurasi proxy HTTP secara manual untuk emulator. Untuk mengetahui informasi selengkapnya, baca Menggunakan emulator dengan proxy.

Setelan > Lanjutan
  • OpenGL ES renderer: Memilih jenis akselerasi grafis. (Ini setara dengan opsi command line -gpu).
    • Autodetect based on host: Memungkinkan emulator memilih akselerasi grafis hardware atau software berdasarkan setelan komputer Anda. Emulator akan memeriksa apakah driver GPU Anda cocok dengan daftar driver GPU rusak yang dikenali. Jika cocok, emulator akan menonaktifkan emulasi hardware grafis dan akan menggunakan CPU sebagai gantinya.
    • ANGLE: (Khusus Windows.) Menggunakan ANGLE Direct3D untuk merender grafis dalam software.
    • SwiftShader: Menggunakan SwiftShader untuk merender gambar dalam software.
    • Desktop native OpenGL: Menggunakan GPU pada komputer host Anda. Opsi ini biasanya yang paling cepat. Namun, beberapa driver memiliki masalah dengan rendering grafis OpenGL, jadi mungkin ini bukanlah pilihan yang dapat diandalkan.
  • OpenGL ES API level: Memilih versi maksimum OpenGL ES untuk digunakan dalam emulator.
    • Autoselect: Memungkinkan emulator memilih versi OpenGL ES berdasarkan dukungan tamu dan host.
    • Renderer maximum (up to OpenGL ES 3.1): Mencoba menggunakan versi maksimum OpenGL ES.
    • Compatibility (OpenGL ES 1.1/2.0): Menggunakan versi OpenGL ES yang kompatibel dengan sebagian besar lingkungan.
Bantuan > Pintasan Keyboard

Panel ini menyediakan daftar pintasan keyboard lengkap untuk emulator. Untuk membuka panel ini sambil bekerja di emulator, tekan F1 (Command+/ di macOS).

Agar pintasan berfungsi, opsi Send keyboard shortcuts di panel setelan General harus disetel ke Emulator controls (default).

Help > Emulator Help

Untuk melihat dokumentasi online terkait emulator, klik Documentation.

Untuk melaporkan bug dalam emulator, klik Send feedback. Untuk mengetahui informasi selengkapnya, pelajari cara melaporkan bug emulator.

Bantuan > Tentang

Perhatikan port adb apa yang digunakan emulator, serta nomor versi emulator dan Android. Bandingkan versi emulator terbaru dengan versi yang dipakai untuk mengetahui apakah Anda menginstal software terbaru.

Nomor seri emulator adalah emulator-adb_port, yang dapat Anda tentukan sebagai opsi command line adb, misalnya.