จัดการการโทรโดยใช้ Telecom API

คู่มือนี้จะอธิบายวิธีกำหนดเส้นทางเสียงสำหรับอุปกรณ์บลูทูธโดยใช้ Telecom API และตั้งค่าการเชื่อมต่อสำหรับการโทรผ่าน 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();
  }
}

ตรวจสอบว่าไฟล์ Manifest ชี้ไปยังคลาส 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]);

การใช้ API ระดับ 23 ขึ้นไป

เปิดใช้ ROUTE_BLUETOOTH โดยไม่ต้องระบุอุปกรณ์โดยใช้ setAudioRoute(int) ซึ่งจะกำหนดค่าเริ่มต้นการกำหนดเส้นทางไปยังอุปกรณ์บลูทูธที่ใช้งานอยู่ในปัจจุบันบน Android 9 ขึ้นไป

setAudioRoute(CallAudioState.ROUTE_BLUETOOTH);