Mengelola panggilan menggunakan Telecom API

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

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);