คู่มือนี้จะอธิบายวิธีกำหนดเส้นทางเสียงสำหรับอุปกรณ์บลูทูธโดยใช้ 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();
กำหนดเส้นทางเสียงการโทร
การใช้ API ระดับ 28 ขึ้นไป (แนะนำ)
ส่งเสียงการโทรไปยังอุปกรณ์บลูทูธที่พร้อมใช้งานโดยใช้ requestBluetoothAudio(BluetoothDevice):
requestBluetoothAudio(availableBluetoothDevices[0]);
การใช้ API ระดับ 23 ขึ้นไป
เปิดใช้ ROUTE_BLUETOOTH โดยไม่ต้องระบุอุปกรณ์โดยใช้ setAudioRoute(int) ซึ่งจะกำหนดค่าเริ่มต้นการกำหนดเส้นทางไปยังอุปกรณ์บลูทูธที่ใช้งานอยู่ในปัจจุบันบน Android 9 ขึ้นไป
setAudioRoute(CallAudioState.ROUTE_BLUETOOTH);