Panduan ini membahas cara merutekan audio untuk perangkat Bluetooth menggunakan Telecom API dan menyetel koneksi untuk panggilan VoIP. Baca panduan Membuat aplikasi panggilan sebelum melanjutkan.
Dengan menggunakan class ConnectionService dan Connection, Anda dapat
mengakses status audio dan daftar perangkat Bluetooth yang tersedia, serta dapat mengarahkan
audio ke perangkat Bluetooth yang dipilih.
Koneksi VoIP dan ConnectionService
Buat class VoIPConnection yang diperluas dari Connection. Class ini
mengontrol status panggilan saat ini. Seperti yang dinyatakan dalam panduan Membuat aplikasi panggilan,
buat aplikasi ini sebagai aplikasi yang dikelola sendiri dan tetapkan mode audio untuk aplikasi
VoIP.
Kotlin
class VoIPConnection : Connection() {
init {
setConnectionProperties(PROPERTY_SELF_MANAGED)
setAudioModeIsVoip(true)
}
}
Java
public class VoIPConnection extends Connection {
public VoIPConnection() {
setConnectionProperties(PROPERTY_SELF_MANAGED);
setAudioModeIsVoip(true);
}
}
Selanjutnya, tampilkan instance class ini di ConnectionService saat terjadi
panggilan masuk atau keluar.
Kotlin
class VoIPConnectionService : ConnectionService() {
override fun onCreateOutgoingConnection(
connectionManagerPhoneAccount: PhoneAccountHandle,
request: ConnectionRequest,
): Connection {
return VoIPConnection()
}
}
Java
public class VoIPConnectionService extends ConnectionService {
@Override
public Connection onCreateOutgoingConnection(PhoneAccountHandle connectionManagerPhoneAccount, ConnectionRequest request) {
return new VoIPConnection();
}
}
Pastikan manifes mengarah ke class VoIPConnectionService dengan benar.
<service android:name=".voip.TelegramConnectionService" android:permission="android.permission.BIND_TELECOM_CONNECTION_SERVICE">
<intent-filter>
<action android:name="android.telecom.ConnectionService"/>
</intent-filter>
</service>
Dengan class Connection dan ConnectionService kustom ini, Anda
dapat mengontrol perangkat dan jenis pemilihan rute audio yang ingin digunakan selama
panggilan.
Mendapatkan status audio saat ini
Untuk mendapatkan status audio saat ini, panggil getCallAudioState.
getCallAudioState menampilkan apakah perangkat melakukan streaming menggunakan
Bluetooth, earpiece, headset berkabel, atau speaker.
mAudioState = connection.getCallAudioState()
Saat status berubah
Berlangganan perubahan di CallAudioState dengan mengganti
onCallAudioStateChanged(). Tindakan ini akan memberi tahu Anda jika ada perubahan pada status.
Kotlin
fun onCallAudioStateChanged(audioState: CallAudioState) {
mAudioState = audioState
}
Java
@Override
public void onCallAudioStateChanged(CallAudioState audioState) {
mAudioState = audioState;
}
Mendapatkan perangkat saat ini
Dapatkan perangkat aktif saat ini menggunakan
CallAudioState.getActiveBluetoothDevice(). Fungsi ini menampilkan
perangkat Bluetooth yang aktif.
Kotlin
val activeDevice: BluetoothDevice = mAudioState.getActiveBluetoothDevice()
Java
BluetoothDevice activeDevice = mAudioState.getActiveBluetoothDevice();
Mendapatkan perangkat Bluetooth
Dapatkan daftar perangkat Bluetooth yang tersedia untuk pemilihan rute audio panggilan menggunakan
CallAudioState.getSupportedBluetoothDevices().
Kotlin
val availableBluetoothDevices: Collection<BluetoothDevice> =
mAudioState.getSupportedBluetoothDevices()
Java
Collection<BluetoothDevice> availableBluetoothDevices = mAudioState.getSupportedBluetoothDevices();
Mengarahkan audio panggilan
Menggunakan level API 28 dan yang lebih tinggi (direkomendasikan)
Rutekan audio panggilan ke perangkat Bluetooth yang tersedia menggunakan
requestBluetoothAudio(BluetoothDevice):
requestBluetoothAudio(availableBluetoothDevices[0]);
Menggunakan level API 23 dan yang lebih tinggi
Aktifkan ROUTE_BLUETOOTH tanpa menentukan perangkat menggunakan
setAudioRoute(int). Tindakan ini akan menetapkan perutean default ke perangkat Bluetooth yang aktif saat ini di Android 9 dan yang lebih baru.
setAudioRoute(CallAudioState.ROUTE_BLUETOOTH);