Telecom API'yi kullanarak aramaları yönetme

Bu kılavuzda, Telecom API'yi kullanarak Bluetooth cihazlar için ses yönlendirme ve VoIP aramaları için bağlantı oluşturma işlemleri açıklanmaktadır. Devam etmeden önce Arama uygulaması oluşturma kılavuzunu okuyun.

ConnectionService ve Connection sınıflarını kullanarak ses durumuna ve kullanılabilir Bluetooth cihazlarının listesine erişebilir, sesi seçili bir Bluetooth cihazına yönlendirebilirsiniz.

VoIP Bağlantısı ve ConnectionService

Connection sınıfından genişletilen bir VoIPConnection sınıfı oluşturun. Bu sınıf, mevcut aramanın durumunu kontrol eder. Arama uygulaması oluşturma kılavuzunda belirtildiği gibi, bu uygulamayı kendi kendine yönetilen bir uygulama yapın ve VoIP uygulaması için ses modunu ayarlayın.

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

Ardından, gelen veya giden bir arama olduğunda ConnectionService içinde bu sınıfın bir örneğini döndürün.

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

Manifestin VoIPConnectionService sınıfını doğru şekilde işaret ettiğinden emin olun.

<service android:name=".voip.TelegramConnectionService" android:permission="android.permission.BIND_TELECOM_CONNECTION_SERVICE">
  <intent-filter>
    <action android:name="android.telecom.ConnectionService"/>
  </intent-filter>
</service>

Bu özel Connection ve ConnectionService sınıflarıyla, görüşme sırasında hangi cihazı ve ne tür bir ses yönlendirmeyi kullanmak istediğinizi kontrol edebilirsiniz.

Mevcut ses durumunu alma

Mevcut ses durumunu almak için getCallAudioState yöntemini çağırın. getCallAudioState, cihazın Bluetooth, kulaklık, kablolu mikrofonlu kulaklık veya hoparlör kullanarak ses aktarıp aktarmadığını döndürür.

mAudioState = connection.getCallAudioState()

Durum değiştiğinde

onCallAudioStateChanged() yöntemini geçersiz kılarak CallAudioState'teki değişikliklere abone olun. Bu, durumdaki değişiklikleri size bildirir.

Kotlin

fun onCallAudioStateChanged(audioState: CallAudioState) {
  mAudioState = audioState
}

Java

@Override
public void onCallAudioStateChanged(CallAudioState audioState) {
  mAudioState = audioState;
}

Mevcut cihazı alma

CallAudioState.getActiveBluetoothDevice() kullanarak etkin cihazı alın. Bu işlev, etkin Bluetooth cihazını döndürür.

Kotlin

val activeDevice: BluetoothDevice = mAudioState.getActiveBluetoothDevice()

Java

BluetoothDevice activeDevice = mAudioState.getActiveBluetoothDevice();

Bluetooth cihazları alma

CallAudioState.getSupportedBluetoothDevices() kullanarak arama sesini yönlendirmek için kullanılabilecek Bluetooth cihazların listesini alın.

Kotlin

val availableBluetoothDevices: Collection<BluetoothDevice> =
  mAudioState.getSupportedBluetoothDevices()

Java

Collection<BluetoothDevice> availableBluetoothDevices = mAudioState.getSupportedBluetoothDevices();

Arama sesini yönlendirme

Arama sesini, requestBluetoothAudio(BluetoothDevice) kullanarak kullanılabilir bir Bluetooth cihaza yönlendirin:

requestBluetoothAudio(availableBluetoothDevices[0]);

API düzeyi 23 ve sonraki sürümleri kullanma

setAudioRoute(int) kullanarak cihazı belirtmeden ROUTE_BLUETOOTH özelliğini etkinleştirin. Bu, Android 9 ve sonraki sürümlerde yönlendirmeyi varsayılan olarak mevcut, etkin Bluetooth cihazlarına yapar.

setAudioRoute(CallAudioState.ROUTE_BLUETOOTH);