ข้ามไปยังเนื้อหา

ตัวจัดการอีเวนต์การโทรแบบกำหนดเองบน Android

ตัวจัดการอีเวนต์การโทรแบบกำหนดเองคือคลาส Java ของคุณเองที่รับอีเวนต์การโทร VoIP ทางฝั่ง Android แบบเนทีฟ ใช้เพื่อเปิดหน้าจอการโทรของคุณเองเมื่อผู้ใช้รับสาย หรือเพื่อส่งอีเวนต์การโทรไปยังส่วนของแอปที่ WebView หลักเข้าไม่ถึง เช่น activity ที่สองซึ่งมี WebView ของตัวเอง

วิธีการทำงานของตัวจัดการ

Anchor link to
  • สำหรับอีเวนต์การโทรแต่ละครั้ง ปลั๊กอินจะส่งอีเวนต์ JavaScript ไปยัง WebView หลักก่อน แล้วจึงเรียกตัวจัดการของคุณ listener ของ registerEvent ยังคงทำงานตามปกติ
  • เมื่อตั้งค่าตัวจัดการไว้ ปลั๊กอินจะไม่นำแอปขึ้นมาอยู่เบื้องหน้าเมื่อผู้ใช้รับสาย หากไม่มีตัวจัดการ ปลั๊กอินจะเปิด launcher activity ของแอป หากมีตัวจัดการ ให้เปิดหน้าจอของคุณใน onAnswer มิฉะนั้นแอปจะยังอยู่ในเบื้องหลัง
  • ปลั๊กอินจะอ่านชื่อคลาสจาก manifest ของแอปเมื่อเกิดอีเวนต์การโทรครั้งแรกหลังจากโปรเซสของแอปเริ่มทำงาน และสร้างคลาสผ่าน reflection คลาสต้องมี public constructor ที่ไม่มีอาร์กิวเมนต์
  • callback จะไม่ได้รับ Context ให้เก็บ Context ของแอปพลิเคชันไว้ในแอปของคุณ เช่น ในคลาสย่อยของ Application เหมือนที่ MyApp.context() ทำในตัวอย่างด้านล่าง

อีเวนต์การโทร

Anchor link to

ตัวจัดการจะ implement com.pushwoosh.calls.listener.CallEventListener ให้ implement เมธอดทั้งแปดเมธอด และปล่อยเมธอดที่ไม่ต้องการให้ว่างไว้

เมธอดถูกเรียกเมื่ออีเวนต์ JavaScript
onCreateIncomingConnection(Bundle payload)สายเรียกเข้าเริ่มดังvoipPushPayload
onAnswer(PushwooshVoIPMessage message, int videoState)ผู้ใช้รับสายanswer
onReject(PushwooshVoIPMessage message)ผู้ใช้ปฏิเสธสายreject
onDisconnect(PushwooshVoIPMessage message)การโทรสิ้นสุดhangup
onCallCancelled(PushwooshVoIPMessage message)พุชยกเลิกทำให้การโทรถูกยกเลิกvoipDidCancelCall
onCallCancellationFailed(String callId, String reason)ไม่สามารถใช้พุชยกเลิกได้voipDidFailToCancelCall
onCallAdded(PushwooshVoIPMessage message)บริการ in-call ของระบบเพิ่มการโทรไม่มี
onCallRemoved(PushwooshVoIPMessage message)บริการ in-call ของระบบนำการโทรออกไม่มี

PushwooshVoIPMessage ให้ค่าต่างๆ จากพุช VoIP:

Getterค่าที่ส่งคืน
getCallId()callId หรือ null หากพุชไม่มีค่านี้
getCallerName()callerName หรือ Unknown Caller หากพุชไม่มีค่านี้
getHasVideo()video
getSupportsHolding()supportsHolding
getSupportsDTMF()supportsDTMF
getCancelCall()cancelCall
getRawPayload()Bundle ทั้งหมดของพุช รวมถึงคีย์ที่คุณกำหนดเอง

onCreateIncomingConnection จะได้รับ Bundle ดิบ หากต้องการใช้ getter ในเมธอดนี้ ให้ห่อด้วย new PushwooshVoIPMessage(payload)

1. ลงทะเบียนตัวจัดการใน manifest

Anchor link to

เพิ่มรายการ meta-data ลงใน <application> พร้อมชื่อคลาสแบบเต็มของตัวจัดการ:

<application ...>
<meta-data
android:name="com.pushwoosh.cordova.CALL_EVENT_HANDLER"
android:value="com.example.app.MyCallEventHandler" />
</application>

ขั้นตอนที่ 3 แสดงตำแหน่งที่ต้องใส่รายการนี้ใน Cordova และ Capacitor

2. เขียนตัวจัดการ

Anchor link to

ตัวจัดการนี้จะเปิดหน้าจอการโทรของคุณเมื่อผู้ใช้รับสาย และส่งอีเวนต์การโทรแต่ละรายการเป็น broadcast ภายในแอป:

public class MyCallEventHandler implements CallEventListener {
public static final String ACTION_CALL_EVENT = "com.example.app.CALL_EVENT";
/**
* Called when the user answers the call.
* Opens the app on the call screen and broadcasts the event to the rest of the app.
*/
@Override
public void onAnswer(@NonNull PushwooshVoIPMessage message, int videoState) {
Context context = MyApp.context(); // your application Context
Intent intent = new Intent(context, VideoCallActivity.class)
.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK
| Intent.FLAG_ACTIVITY_CLEAR_TOP
| Intent.FLAG_ACTIVITY_SINGLE_TOP)
.putExtra("callId", message.getCallId());
context.startActivity(intent);
broadcast("answer", message);
}
@Override
public void onReject(@NonNull PushwooshVoIPMessage message) {
broadcast("reject", message);
}
@Override
public void onDisconnect(@NonNull PushwooshVoIPMessage message) {
broadcast("hangup", message);
}
@Override
public void onCallCancelled(@NonNull PushwooshVoIPMessage message) {
broadcast("cancelled", message);
}
@Override public void onCreateIncomingConnection(@Nullable Bundle payload) {}
@Override public void onCallAdded(@NonNull PushwooshVoIPMessage message) {}
@Override public void onCallRemoved(@NonNull PushwooshVoIPMessage message) {}
@Override public void onCallCancellationFailed(@Nullable String callId, @NonNull String reason) {}
private static void broadcast(String event, PushwooshVoIPMessage message) {
Context context = MyApp.context(); // your application Context
Intent intent = new Intent(ACTION_CALL_EVENT)
.setPackage(context.getPackageName())
.putExtra("event", event)
.putExtra("callId", message.getCallId());
context.sendBroadcast(intent);
}
}

3. เพิ่มโค้ดลงในโปรเจกต์

Anchor link to

เพิ่มคลาสตัวจัดการลงใน android/app/src/main/java/ และเพิ่มรายการ meta-data จากขั้นตอนที่ 1 ลงใน android/app/src/main/AndroidManifest.xml

เพิ่ม Pushwoosh calls SDK ลงในโมดูลแอปใน android/app/build.gradle ใช้เวอร์ชันที่ตั้งไว้ใน src/android/add-android-voip.gradle ของปลั๊กอิน:

dependencies {
compileOnly "com.pushwoosh:pushwoosh-calls:6.17.1"
}

หากไม่เพิ่ม การ build จะล้มเหลวด้วยข้อผิดพลาด package com.pushwoosh.calls.listener does not exist เนื่องจากปลั๊กอินเพิ่ม calls SDK เฉพาะในโมดูลของตัวเองเท่านั้น

Cordova จะสร้างโปรเจกต์เนทีฟขึ้นใหม่ ดังนั้นให้เพิ่มตัวจัดการผ่านปลั๊กอินภายในเครื่อง plugin.xml ของปลั๊กอินนั้นจะคัดลอกคลาสและเพิ่ม meta-data ลงใน manifest:

<platform name="android">
<source-file src="src/android/MyCallEventHandler.java" target-dir="src/com/example/app" />
<config-file target="AndroidManifest.xml" parent="/manifest/application">
<meta-data android:name="com.pushwoosh.cordova.CALL_EVENT_HANDLER"
android:value="com.example.app.MyCallEventHandler" />
</config-file>
</platform>

Cordova ไม่ต้องใช้ dependency ของ Gradle เพิ่มเติม

ลิงก์ที่เกี่ยวข้อง

Anchor link to