إدارة المكالمات باستخدام واجهة برمجة التطبيقات Telecom

يتناول هذا الدليل كيفية توجيه الصوت للأجهزة التي تتضمّن بلوتوث باستخدام واجهة برمجة تطبيقات Telecom وضبط الاتصال لمكالمات VoIP. يُرجى قراءة دليل إنشاء تطبيق اتصال قبل المتابعة.

باستخدام الفئتَين ConnectionService وConnection، يمكنك الوصول إلى حالة الصوت وقائمة بأجهزة يتضمّن بلوتوث المتاحة، ويمكنك توجيه الصوت إلى جهاز يتضمّن بلوتوث محدّد.

اتصال VoIP وConnectionService

أنشِئ فئة VoIPConnection تمتد من Connection. تتحكّم هذه الفئة في حالة المكالمة الحالية. كما هو موضّح في دليل إنشاء تطبيق اتصال، يجب ضبط هذا التطبيق على أنّه تطبيق مُدار ذاتيًا وضبط وضع الصوت لتطبيق 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);
  }
}

بعد ذلك، يمكنك عرض مثيل لهذه الفئة في ConnectionService عند إجراء مكالمة واردة أو صادرة.

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

تأكَّد من أنّ ملف البيان يشير بشكل صحيح إلى فئة VoIPConnectionService.

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

باستخدام فئتَي Connection وConnectionService المخصّصتين، يمكنك التحكّم في الجهاز ونوع توجيه الصوت الذي تريد استخدامه أثناء المكالمة.

الحصول على حالة الصوت الحالية

للحصول على حالة الصوت الحالية، يمكنك استدعاء getCallAudioState. تعرض الدالة getCallAudioState ما إذا كان الجهاز يبث المحتوى باستخدام بلوتوث أو سماعة أذن أو سماعة رأس سلكية أو مكبّر صوت.

mAudioState = connection.getCallAudioState()

عند تغيير الحالة

يمكنك الاشتراك في التغييرات في CallAudioState من خلال إلغاء onCallAudioStateChanged(). يؤدي ذلك إلى تنبيهك بأي تغييرات في الحالة.

Kotlin

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

Java

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

الحصول على الجهاز الحالي

يمكنك الحصول على الجهاز النشط حاليًا باستخدام CallAudioState.getActiveBluetoothDevice(). تعرض هذه الدالة الجهاز النشط الذي يتضمّن بلوتوث.

Kotlin

val activeDevice: BluetoothDevice = mAudioState.getActiveBluetoothDevice()

Java

BluetoothDevice activeDevice = mAudioState.getActiveBluetoothDevice();

الحصول على أجهزة تتضمّن بلوتوث

يمكنك الحصول على قائمة بأجهزة يتضمّن بلوتوث المتاحة لتوجيه صوت المكالمات باستخدام CallAudioState.getSupportedBluetoothDevices().

Kotlin

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

Java

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

توجيه صوت المكالمة

توجيه صوت المكالمة إلى جهاز يتضمّن بلوتوث ومتاح باستخدام requestBluetoothAudio(BluetoothDevice):

requestBluetoothAudio(availableBluetoothDevices[0]);

استخدام مستوى واجهة برمجة التطبيقات 23 والإصدارات الأحدث

تفعيل ROUTE_BLUETOOTH بدون تحديد الجهاز باستخدام setAudioRoute(int) يؤدي هذا الإعداد إلى توجيه الصوت تلقائيًا إلى أجهزة Bluetooth النشطة حاليًا على نظام التشغيل Android 9 والإصدارات الأحدث.

setAudioRoute(CallAudioState.ROUTE_BLUETOOTH);