Bluetooth

Android menyediakan implementasi Bluetooth lengkap dengan dukungan untuk banyak profil Bluetooth dalam mobil yang umum. Ada juga banyak peningkatan yang meningkatkan kinerja dan pengalaman dengan perangkat dan layanan lain.

Manajemen koneksi Bluetooth

Dalam Android, CarBluetoothService memelihara perangkat Bluetooth pengguna saat ini dan daftar prioritas untuk setiap koneksi profil ke IVI. Perangkat terhubung ke profil dalam urutan prioritas yang ditentukan. Kapan mengaktifkan, menonaktifkan, dan menghubungkan perangkat ke profil didorong oleh kebijakan koneksi default yang dapat diganti dengan penggunaan hamparan sumber daya , jika diinginkan.

Mengonfigurasi manajemen koneksi otomotif

Nonaktifkan kebijakan telepon default

Tumpukan Bluetooth Android mempertahankan kebijakan koneksi untuk ponsel yang diaktifkan secara default. Kebijakan ini harus dinonaktifkan di perangkat Anda agar tidak bertentangan dengan kebijakan otomotif yang dimaksud di CarBluetoothService . Sementara overlay produk Mobil harus menangani ini untuk Anda, Anda dapat menonaktifkan kebijakan telepon di overlay sumber daya dengan menyetel enable_phone_policy ke false di /packages/apps/Bluetooth/res/values/config.xml .

Gunakan kebijakan otomotif default

CarBluetoothService mempertahankan izin profil default. Daftar perangkat yang dikenal dan prioritas koneksi ulang profilnya ada di service/src/com/android/car/BluetoothProfileDeviceManager.java .

Selain itu, kebijakan manajemen koneksi Bluetooth dapat ditemukan di service/src/com/android/car/BluetoothDeviceConnectionPolicy.java . Secara default, kebijakan ini menentukan instance saat Bluetooth harus terhubung dan memutuskan sambungan dari perangkat terikat. Ini juga mengelola kasus khusus mobil ketika adaptor harus dihidupkan dan dimatikan.

Membuat kebijakan manajemen koneksi otomotif kustom Anda sendiri

Jika kebijakan otomotif default tidak cukup untuk kebutuhan Anda, itu juga dapat dinonaktifkan demi kebijakan kustom Anda sendiri. Kebijakan khusus Anda akan, minimal, bertanggung jawab untuk menentukan kapan harus mengaktifkan dan menonaktifkan adaptor Bluetooth, serta kapan harus menghubungkan perangkat. Dimungkinkan untuk menggunakan berbagai peristiwa untuk mengaktifkan/menonaktifkan adaptor Bluetooth dan untuk memulai koneksi perangkat, termasuk peristiwa karena perubahan properti mobil tertentu.

Nonaktifkan kebijakan otomotif default

Pertama, untuk menggunakan kebijakan khusus, kebijakan otomotif default harus dinonaktifkan dengan menyetel useDefaultBluetoothConnectionPolicy ke false dalam hamparan sumber daya . Sumber daya ini awalnya didefinisikan sebagai bagian dari packages/services/Car/service/res/values/config.xml .

Aktifkan dan Nonaktifkan Adaptor Bluetooth

Salah satu fungsi inti dari kebijakan Anda adalah menghidupkan dan mematikan adaptor Bluetooth pada waktu yang tepat. Anda dapat menggunakan API framework BluetoothAdapter.enable() dan BluetoothAdapter.disable() untuk mengaktifkan dan menonaktifkan adaptor. Panggilan ini harus menghormati status bertahan yang telah dipilih pengguna melalui Pengaturan atau cara lain apa pun. Salah satu caranya adalah sebagai berikut:

/**
 * Turn on the Bluetooth Adapter.
 */
private void enableBluetooth() {
    BluetoothAdapter bluetoothAdapter = BluetoothAdapter.getDefaultAdapter();
    if (bluetoothAdapter == null) {
        return;
    }
    bluetoothAdapter.enable();
}

/**
 * Turn off the Bluetooth Adapter
 */
private void disableBluetooth() {
    BluetoothAdapter bluetoothAdapter = BluetoothAdapter.getDefaultAdapter();
    if (bluetoothAdapter == null) {
        return;
    }
    // Will shut down _without_ persisting the off state as the desired state
    // of the Bluetooth adapter for next start up. This will do nothing if the adapter
    // is already off, keeping the existing saved desired state for next reboot.
    bluetoothAdapter.disable(false);
}

Tentukan kapan harus menghidupkan dan mematikan adaptor Bluetooth

Dengan kebijakan kustom Anda, Anda bebas menentukan peristiwa mana yang menunjukkan waktu terbaik untuk mengaktifkan dan menonaktifkan adaptor. Salah satu cara untuk melakukan ini adalah dengan menggunakan status daya yang dikelola oleh CarPowerManager :

private final CarPowerStateListenerWithCompletion mCarPowerStateListener =
        new CarPowerStateListenerWithCompletion() {
    @Override
    public void onStateChanged(int state, CompletableFuture<Void> future) {
        if (state == CarPowerManager.CarPowerStateListener.ON) {
            if (isBluetoothPersistedOn()) {
                enableBluetooth();
            }
            return;
        }

        // "Shutdown Prepare" is when the user will perceive the car as off
        // This is a good time to turn off Bluetooth
        if (state == CarPowerManager.CarPowerStateListener.SHUTDOWN_PREPARE) {
            disableBluetooth();

            // Let CarPowerManagerService know we're ready to shut down
            if (future != null) {
                future.complete(null);
            }
            return;
        }
    }
};

Tentukan kapan harus menghubungkan perangkat

Demikian pula, setelah Anda menentukan peristiwa yang harus memicu koneksi perangkat untuk memulai, CarBluetoothManager menyediakan panggilan API connectDevices() yang akan melanjutkan untuk menghubungkan perangkat berdasarkan daftar prioritas yang ditentukan untuk setiap profil Bluetooth.

Salah satu contoh saat Anda mungkin ingin melakukan ini adalah setiap kali adaptor Bluetooth menyala:

private class BluetoothBroadcastReceiver extends BroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {
        String action = intent.getAction();
        BluetoothDevice device = intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE);
        if (BluetoothAdapter.ACTION_STATE_CHANGED.equals(action)) {
            int state = intent.getIntExtra(BluetoothAdapter.EXTRA_STATE, -1);
            if (state == BluetoothAdapter.STATE_ON) {
                // mContext should be your application’s context
                Car car = Car.createCar(mContext);
                CarBluetoothManager carBluetoothManager =
                        (CarBluetoothManager) car.getCarManager(Car.BLUETOOTH_SERVICE);
                carBluetoothManager.connectDevices();
            }
        }
    }
}

Memverifikasi manajemen koneksi otomotif

Cara termudah untuk memverifikasi perilaku kebijakan koneksi Anda adalah dengan mengaktifkan Bluetooth di IVI Anda dan memvalidasi bahwa itu secara otomatis terhubung ke perangkat yang benar dalam urutan yang sesuai. Anda dapat mengaktifkan adaptor Bluetooth melalui UI pengaturan, atau dengan perintah adb berikut:

adb shell su u$(adb shell am get-current-user)_system svc bluetooth disable
adb shell su u$(adb shell am get-current-user)_system svc bluetooth enable

Selain itu, output dari perintah berikut dapat digunakan untuk melihat informasi debug terkait koneksi Bluetooth:

adb shell dumpsys car_service

Terakhir, jika Anda telah membuat kebijakan otomotif sendiri, memverifikasi perilaku sambungan khusus apa pun akan memerlukan pengontrolan peristiwa yang Anda pilih untuk memicu sambungan perangkat.

Profil Bluetooth otomotif

Di Android, IVI dapat mendukung beberapa perangkat yang terhubung secara bersamaan melalui Bluetooth. Layanan telepon Bluetooth multi-perangkat memungkinkan pengguna menghubungkan perangkat terpisah secara bersamaan, seperti telepon pribadi dan telepon kantor, dan melakukan panggilan handsfree dari salah satu perangkat.

Batas koneksi diberlakukan oleh masing-masing profil Bluetooth, biasanya dalam implementasi layanan profil itu sendiri. Secara default, CarBluetoothService tidak membuat penilaian lebih lanjut tentang jumlah maksimum perangkat terhubung yang diizinkan.

Profil Bebas Genggam

Bluetooth Hands-Free Profile (HFP) memungkinkan kendaraan untuk membuat dan menerima panggilan telepon melalui perangkat jarak jauh yang terhubung. Setiap sambungan perangkat mendaftarkan akun telepon terpisah dengan TelecomManager , yang mengiklankan semua akun telepon yang tersedia ke aplikasi IVI.

IVI dapat terhubung ke beberapa perangkat melalui HFP. MAX_STATE_MACHINES_POSSIBLE di HeadsetClientService menentukan jumlah maksimum koneksi HFP simultan.

Saat pengguna membuat atau menerima panggilan telepon dari perangkat, akun telepon terkait membuat objek HfpClientConnection . Aplikasi Dialer berinteraksi dengan objek HfpClientConnection untuk mengelola fitur panggilan, seperti menerima panggilan atau menutup telepon.

Perlu dicatat bahwa aplikasi Dialer default tidak mendukung beberapa perangkat HFP yang terhubung secara bersamaan. Untuk menerapkan HFP multi-perangkat, penyesuaian diperlukan agar pengguna dapat memilih akun perangkat mana yang akan digunakan saat melakukan panggilan. Aplikasi kemudian akan memanggil telecomManager.placeCall dengan akun yang benar. Anda perlu memverifikasi bahwa fungsionalitas multi-perangkat lainnya juga berfungsi sebagaimana dimaksud.

Verifikasi HFP multi-perangkat

Untuk memeriksa apakah konektivitas multi-perangkat berfungsi dengan baik melalui Bluetooth:

  1. Menggunakan Bluetooth, sambungkan perangkat ke IVI dan streaming audio dari perangkat.
  2. Hubungkan dua ponsel ke IVI melalui Bluetooth.
  3. Pilih satu telepon. Lakukan panggilan keluar langsung dari telepon, dan lakukan panggilan keluar menggunakan IVI.
    1. Kedua kali, verifikasi jeda audio yang dialirkan dan audio telepon diputar melalui speaker yang terhubung IVI.
  4. Menggunakan telepon yang sama, menerima panggilan masuk langsung di telepon, dan menerima panggilan masuk menggunakan IVI.
    1. Kedua kali, verifikasi jeda audio streaming dan audio telepon diputar melalui speaker yang terhubung IVI.
  5. Ulangi langkah 3 dan 4 dengan telepon lain yang terhubung.

Panggilan Darurat

Kemampuan untuk melakukan panggilan darurat merupakan aspek penting dari fungsi telepon dan Bluetooth di dalam mobil. Ada beberapa cara panggilan darurat dapat dimulai dari IVI, termasuk:

  • Solusi eCall mandiri
  • Solusi eCall terintegrasi ke dalam IVI
  • Mengandalkan ponsel Bluetooth yang terhubung saat tidak ada sistem built-in yang tersedia

Menghubungkan panggilan darurat

Meskipun peralatan eCall sangat penting untuk keselamatan, saat ini tidak terintegrasi ke dalam Android. Dimungkinkan untuk menggunakan ConnectionService untuk mengekspos fitur panggilan darurat melalui Android, yang juga memiliki manfaat memperkenalkan opsi aksesibilitas untuk panggilan darurat. Untuk mempelajari lebih lanjut, lihat Membuat aplikasi panggilan .

Berikut adalah contoh cara membuat ConnectionService darurat :

public class YourEmergencyConnectionService extends ConnectionService {

    @Override
    public Connection onCreateOutgoingConnection(
            PhoneAccountHandle connectionManagerAccount,
            ConnectionRequest request) {
        // Your equipment specific procedure to make ecall
        // ...
    }

    private void onYourEcallEquipmentReady() {

        PhoneAccountHandle handle =
            new PhoneAccountHandle(new ComponentName(context, YourEmergencyConnectionService),
                    YourEmergencyConnectionId);
        PhoneAccount account =
            new PhoneAccount.Builder(handle, eCallOnlyAccount)
            .setSupportedUriSchemes(Arrays.asList(PhoneAccount.SCHEME_TEL))
            .setCapabilities(PhoneAccount.CAPABILITY_PLACE_EMERGENCY_CALLS
                    | PhoneAccount.CAPABILITY_MULTI_USER)
            .build():
        mTelecomManager.registerPhoneAcccount(account);
        mTelecomManager.enablePhoneAccount(account.getAccountHandle(), true);
    }
}

Mengaktifkan Bluetooth untuk Panggilan Darurat

Memanggil Darurat sebelum Android 10 melibatkan panggilan langsung dari telepon dan memanggil peralatan khusus jika tersedia (misalnya pemicu otomatis saat mendeteksi bahaya atau tindakan pengguna). Sejak Android 10, Dialer di mobil dapat langsung menghubungi nomor Darurat, asalkan kode ini terdapat di apps/Bluetooth/res/values/config.xml :

<!-- For supporting emergency call through the hfp client connection service --> <bool name=”hfp_client_connection_service_support_emergency_call”>true</bool>

Dengan menerapkan panggilan darurat dengan cara ini, aplikasi lain, seperti pengenalan suara, juga dapat memanggil nomor Darurat.

Profil Akses Buku Telepon

Profil Akses Buku Telepon Bluetooth (PBAP) mengunduh kontak dan riwayat panggilan dari perangkat jarak jauh yang terhubung. PBAP memelihara daftar kontak yang dapat dicari dan dikumpulkan yang diperbarui oleh mesin status klien PBAP. Setiap perangkat yang terhubung berinteraksi dengan mesin status klien PBAP yang terpisah, menghasilkan kontak yang dikaitkan dengan perangkat yang tepat saat melakukan panggilan.

PBAP bersifat searah dan oleh karena itu memerlukan IVI untuk membuat instance koneksi ke perangkat seluler apa pun yang diinginkan. MAXIMUM_DEVICES di PbapClientService menentukan jumlah maksimum koneksi perangkat PBAP simultan yang diizinkan dengan IVI. Klien PBAP menyimpan kontak untuk setiap perangkat yang terhubung di Penyedia Kontak yang kemudian dapat diakses oleh aplikasi untuk mendapatkan buku telepon untuk setiap perangkat.

Selain itu, koneksi profil harus disahkan oleh IVI dan perangkat seluler agar koneksi dapat dibuat. Ketika klien PBAP terputus, database internal menghapus semua kontak dan riwayat panggilan yang terkait dengan perangkat yang terhubung sebelumnya.

Profil Akses Pesan

Bluetooth Message Access Profile (MAP) memungkinkan kendaraan untuk mengirim dan menerima pesan SMS melalui perangkat jarak jauh yang terhubung. Saat ini, pesan tidak disimpan secara lokal di IVI. Sebagai gantinya, setiap kali perangkat jarak jauh yang terhubung menerima pesan, IVI menerima dan mem-parsing pesan dan menyiarkan kontennya dalam Intent , yang kemudian dapat diterima oleh aplikasi.

Agar terhubung ke perangkat seluler untuk tujuan mengirim dan menerima pesan, IVI harus memulai koneksi MAP. MAXIMUM_CONNECTED_DEVICES di MapClientService menentukan jumlah maksimum koneksi perangkat MAP simultan yang diizinkan dengan IVI. Setiap koneksi harus disahkan oleh IVI dan perangkat seluler sebelum pesan dapat ditransfer.

Profil Distribusi Audio Tingkat Lanjut

Profil Distribusi Audio Lanjutan Bluetooth (A2DP) memungkinkan kendaraan menerima aliran audio dari perangkat jarak jauh yang terhubung.

Tidak seperti profil lainnya, jumlah maksimum perangkat A2DP yang terhubung diterapkan di tumpukan asli dan bukan di Java. Nilai saat ini di-hardcode ke 1 menggunakan variabel kDefaultMaxConnectedAudioDevices dalam packages/modules/Bluetooth/system/vtif/src/btif_av.cc .

Profil Kontrol Jarak Jauh Audio/Video

Profil Kontrol Jarak Jauh Audio/Video Bluetooth (AVRCP) memungkinkan kendaraan untuk mengontrol dan menelusuri pemutar media pada perangkat jarak jauh yang terhubung. Karena IVI memainkan peran sebagai pengontrol AVRCP, setiap kontrol yang dipicu yang memengaruhi pemutaran audio bergantung pada koneksi A2DP ke perangkat target.

Agar pemutar media tertentu pada ponsel Android dapat dijelajahi oleh IVI melalui AVRCP, aplikasi media pada ponsel harus menyediakan MediaBrowserService dan mengizinkan akses com.android.bluetooth ke layanan tersebut. Membangun layanan browser media menjelaskan cara melakukan ini secara rinci.