ADB / Android Debug Bridge
Disertakan dengan Macro DeckKendalikan ponsel atau tablet Android lewat USB atau Wi-Fi: bangunkan, mulai aplikasi, ketuk, ketik, dan ambil tangkapan layar.
Tab Ringkasan integrasi ADB / Android Debug Bridge, dengan pemberitahuan untuk mengaktifkan ADB di Pengaturan
- Bangunkan, kunci, dan mulai ulang perangkat Android yang terhubung
- Mulai atau hentikan paksa aplikasi dan buka tautan di perangkat
- Kirim tombol, ketukan, geseran, dan teks
- Simpan tangkapan layar perangkat ke sebuah folder
- Peristiwa dan variabel perangkat untuk baterai, layar, dan aplikasi latar depan
Integrasi ADB mengendalikan ponsel dan tablet Android melalui Android Debug Bridge (ADB), alat yang sama yang digunakan para pengembang Android. Macro Deck menemukan program adb, menjalankan server ADB, dan memantau perangkat yang tersambung lewat USB atau terhubung lewat Wi-Fi. Macro Deck juga dapat mengunduh Android platform-tools resmi untuk Anda.
Setiap aksi bekerja pada perangkat yang dipilih di aksi tersebut, atau pada perangkat bawaan jika Perangkat dibiarkan kosong. Perangkat bawaan adalah perangkat yang dipilih dengan Jadikan bawaan di Pengaturan > ADB, atau satu-satunya perangkat yang tersambung jika belum ada yang dipilih.
Yang dapat dilakukan
- Layar dan daya: bangunkan perangkat, matikan layar (dengan cara inilah Android mengunci perangkat), atau mulai ulang ke Android, recovery, atau bootloader.
- Aplikasi dan tautan: mulai aplikasi atau hentikan paksa berdasarkan nama paketnya, misalnya
com.spotify.music, dan buka tautan dengan aplikasi yang dipilih perangkat untuknya. - Input: kirim tombol seperti Home, Back, Volume Up, atau Media Play Pause, ketuk satu titik di layar, geser dari satu titik ke titik lain, atau ketik teks ke kolom yang sedang aktif.
- Tangkapan layar: tangkap layar sebagai file PNG di sebuah folder di komputer, dan secara opsional tulis lokasi file tersebut ke sebuah variabel.
Beberapa contoh penggunaan:
- Tombol yang membangunkan tablet di meja dan memulai aplikasi musik.
- Tombol yang mengirim Media Play Pause ke ponsel.
- Otomasi pada Perangkat terhubung yang langsung membuka halaman dasbor di tablet begitu tablet dicolokkan.
Status langsung
Integrasi ini melaporkan saat perangkat terhubung, terputus, diotorisasi, tidak lagi diotorisasi, luring, atau kembali daring, sehingga alur dan tombol dapat bereaksi. Variabel menyimpan jumlah perangkat yang terhubung dan yang diotorisasi, serta untuk perangkat bawaan: model, produsen, tingkat baterai, apakah layar menyala, apakah layar kunci tampil, dan aplikasi mana yang ada di depan. Setiap perangkat yang diotorisasi juga mendapat variabelnya sendiri, dinamai sesuai modelnya. Selama integrasi aktif, baterai setiap perangkat Android juga muncul di widget Baterai.
Aksi dasar (tombol, ketukan, geseran, teks, aplikasi, tautan, mulai ulang, dan tangkapan layar) tetap berfungsi saat Macro Deck terkunci, sehingga tombol yang terikat pada aksi tersebut tetap bekerja di komputer yang terkunci.
Yang Anda butuhkan
- Macro Deck 3 di Windows, macOS, atau Linux
- Perangkat Android dengan USB debugging aktif di Opsi pengembang
- Kabel USB yang mendukung transfer data, atau debugging nirkabel untuk koneksi lewat Wi-Fi
- Android platform-tools (adb); Macro Deck dapat mengunduhnya di Pengaturan > ADB
- Di Linux, izin bagi pengguna Anda untuk mengakses perangkat USB, biasanya melalui aturan udev
Cara menyiapkan
Langkah 1: Aktifkan integrasi ADB
Di bilah samping, klik Integrasi, lalu ADB / Android Debug Bridge. Integrasi ini nonaktif sampai Anda mengaktifkan sakelar di kanan atas. Setelah aktif, halaman menampilkan ADB dinonaktifkan sampai Anda mengaktifkan ADB di langkah berikutnya.
Langkah 2: Aktifkan ADB di Macro Deck
Buka Pengaturan > ADB dan aktifkan Aktifkan ADB. Jika Program ADB menampilkan Tidak ditemukan, klik Unduh platform-tools. Android SDK yang sudah ada atau
adbdiPATHditemukan secara otomatis, dan Lokasi program memungkinkan Anda menunjuk ke program lain.Langkah 3: Aktifkan USB debugging di perangkat
Di ponsel atau tablet, buka Pengaturan > Tentang ponsel dan ketuk Nomor build tujuh kali untuk mengaktifkan Opsi pengembang. Lalu aktifkan USB debugging di Pengaturan > Opsi pengembang. Letak persisnya sedikit berbeda antarprodusen.
Langkah 4: Hubungkan dan otorisasi perangkat
Hubungkan perangkat dengan kabel USB dan konfirmasi Allow USB debugging? di layarnya. Centang Always allow from this computer agar tidak ditanyakan lagi. Perangkat kemudian muncul di Perangkat pada Pengaturan > ADB dengan status Siap. Untuk terhubung lewat Wi-Fi, masukkan alamat IP dan port perangkat di Hubungkan lewat Wi-Fi, misalnya
192.168.1.20:5555.Langkah 5: Pilih perangkat bawaan
Jika lebih dari satu perangkat tersambung, klik Jadikan bawaan di samping perangkat yang harus digunakan aksi saat Perangkat dibiarkan kosong. Jika hanya ada satu perangkat, perangkat itu digunakan secara otomatis.
Langkah 6: Tambahkan aksi ADB ke tombol
Di halaman Deck, pastikan deck tidak terkunci (tombol di kanan atas bertuliskan Kunci), lalu klik sebuah tombol. Editor terbuka dengan Ketuk Singkat terpilih. Klik + Tambah aksi, pilih ADB / Android Debug Bridge di sisi kiri dialog Tambah aksi, lalu pilih sebuah aksi, misalnya Bangunkan perangkat atau Mulai aplikasi. Isi kolomnya, seperti Paket untuk Mulai aplikasi, dan biarkan Perangkat kosong untuk menggunakan perangkat bawaan. Kategori ini hanya muncul selama integrasi aktif.
Langkah 7: Tekan tombolnya
Klik Simpan, lalu tekan tombol di deck Anda. Jika tidak terjadi apa-apa, periksa Integrasi untuk melihat pemberitahuan, seperti Tidak ada perangkat yang terhubung atau perangkat yang memerlukan otorisasi.
Aksi11
Pasang aksi ini di tombol atau jalankan dari alur.
- Bangunkan perangkat
- Membangunkan layar perangkat.
- Tidur / Kunci layar
- Mematikan layar perangkat, cara Android mengunci perangkat.
- Mulai aplikasi
- Menjalankan aplikasi berdasarkan nama paketnya, atau membawanya ke depan.
- Hentikan paksa aplikasi
- Menghentikan paksa aplikasi berdasarkan nama paketnya.
- Buka tautan
- Membuka URI di perangkat, sama seperti mengetuk tautan.
- Ketik teks
- Mengetik teks ke kolom yang sedang aktif di perangkat.
- Kirim tombol
- Mengirim satu peristiwa tombol Android, seperti Home, Back, Volume Up, atau Media Next.
- Ketuk
- Mengetuk layar pada koordinat X dan Y yang ditentukan.
- Geser
- Menggeser layar dari satu titik ke titik lain dalam durasi tertentu.
- Mulai ulang perangkat
- Memulai ulang perangkat ke mode Normal, Recovery, atau Bootloader.
- Ambil tangkapan layar
- Menangkap layar perangkat dan menyimpannya sebagai file PNG di sebuah folder, dan secara opsional menulis lokasinya ke sebuah variabel.
Pemicu6
Tombol atau alur dapat bereaksi terhadap peristiwa ini.
- Perangkat terhubung
- Perangkat Android dicolokkan, atau Macro Deck pertama kali melihatnya.
- Perangkat terputus
- Perangkat Android dicabut, atau Macro Deck kehilangan jejaknya.
- Perangkat diotorisasi
- Permintaan otorisasi diterima di perangkat.
- Perangkat tidak lagi diotorisasi
- Perangkat yang sebelumnya diotorisasi perlu menerima permintaan otorisasi lagi.
- Perangkat daring
- Perangkat yang diotorisasi dapat dijangkau lagi.
- Perangkat luring
- Perangkat yang tadinya dapat dijangkau kini tidak dapat dijangkau lagi.
Variabel11
Tampilkan nilai ini di tombol dan widget, atau gunakan dalam kondisi.
adb_connected_device_count- Jumlah perangkat Android yang tersambung.
adb_authorized_device_count- Jumlah perangkat yang daring dan diotorisasi.
adb_device_connected- Apakah perangkat bawaan terhubung.
adb_device_authorized- Apakah perangkat bawaan telah mengotorisasi komputer ini.
adb_device_model- Model perangkat bawaan.
adb_device_manufacturer- Produsen perangkat bawaan.
adb_device_battery_level- Tingkat baterai perangkat bawaan dalam persen.
adb_device_screen_on- Apakah layar perangkat bawaan menyala.
adb_device_locked- Apakah perangkat bawaan menampilkan layar kuncinya.
adb_device_foreground_app- Nama paket aplikasi yang ada di depan pada perangkat bawaan.
adb_device_<device>_connected,adb_device_<device>_authorized,adb_device_<device>_model,adb_device_<device>_battery_level- Status terhubung, status otorisasi, model, dan tingkat baterai setiap perangkat yang diotorisasi.
<device>adalah model perangkat dalam huruf kecil, angka, dan garis bawah, dengan tambahan_2,_3, dan seterusnya untuk perangkat lain dengan model yang sama.
Pertanyaan yang sering diajukan
Apakah Android Studio atau Android SDK diperlukan?
Tidak. Macro Deck hanya membutuhkan program adb dari Android platform-tools. Klik Unduh platform-tools di Pengaturan > ADB, lalu Macro Deck mengunduh paket resmi dari Google, sekitar 15 MB, untuk digunakan sendiri. Instalasi yang sudah ada ditemukan secara otomatis.
Bisakah perangkat dikendalikan lewat Wi-Fi?
Bisa. Aktifkan debugging nirkabel di perangkat dan masukkan alamat IP serta port-nya di Hubungkan lewat Wi-Fi pada Pengaturan > ADB. Macro Deck tidak memasangkan perangkat sendiri: di Android 11 dan yang lebih baru, pasangkan perangkat dengan komputer ini terlebih dahulu, atau alihkan ke debugging jaringan lewat USB dengan adb tcpip. Jika tidak, perangkat akan menolak koneksi.
Mengapa aksi gagal karena tidak ada perangkat yang ditemukan?
Jika Perangkat dibiarkan kosong, aksi menggunakan perangkat bawaan. Jika belum ada yang dipilih dan lebih dari satu perangkat tersambung, tidak ada perangkat bawaan, jadi pilih perangkat di aksi atau klik Jadikan bawaan di Pengaturan > ADB. Periksa juga bahwa perangkat menampilkan Siap dan bukan Belum diotorisasi.
Apakah ada aksi kunci tersendiri?
Tidak. Android tidak memiliki perintah kunci tersendiri. Tidur / Kunci layar mematikan layar, yang mengunci perangkat dengan cara yang sama seperti tombol daya.
Apakah integrasi ADB memengaruhi program lain yang menggunakan ADB?
Macro Deck menggunakan server ADB biasa, sehingga program seperti Android Studio ikut memakainya. Mulai ulang server ADB di Pengaturan > ADB juga memutus sesaat perangkat milik program tersebut. Macro Deck membiarkan server tetap berjalan saat keluar, kecuali Anda mengaktifkan Hentikan server ADB saat Macro Deck keluar.
Mengapa perangkat menampilkan "Tidak memiliki izin untuk mengakses perangkat ini"?
Komputer tidak memiliki izin untuk berkomunikasi dengan perangkat lewat USB. Di Linux, pasang aturan udev platform-tools; di Windows, pasang driver USB dari produsen perangkat.
Lainnya di Komputer Anda
Sistem
Disertakan dengan Macro DeckKendalikan komputer Anda dari deck: aplikasi, volume, perintah, notifikasi, mode tidur, dan mematikan komputer.
Keyboard
Disertakan dengan Macro DeckTekan pintasan, ketik teks, dan jalankan urutan tombol di komputer Anda dari sebuah tombol.
Mouse
Disertakan dengan Macro DeckKlik, gerakkan penunjuk, seret, dan gulir di komputer Anda dari sebuah tombol.
Steam
Disertakan dengan Macro DeckMulai dan tutup game Steam, dan tampilkan apa yang Anda mainkan, teman, dan pustaka di deck Anda.