ตัวจัดการอีเวนต์การโทรแบบกำหนดเองบน 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 toCapacitor
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
Anchor link toCordova จะสร้างโปรเจกต์เนทีฟขึ้นใหม่ ดังนั้นให้เพิ่มตัวจัดการผ่านปลั๊กอินภายในเครื่อง 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 เพิ่มเติม