訂閱事件後,電信主動通知 App:有人來電、通話狀態改變,或註冊已經結束。
GSMA 應用情境
A有人來電
電信通知來電
有人撥給這個門號,電信推送來電邀請,App 開始響鈴。
B通話狀態改變
電信通知保留中
通話中狀態改變,例如對方保留通話,電信推送最新狀態。
C註冊結束
電信通知註冊結束
註冊到期或被網路終止時,電信推送結束通知與原因。
一個訂閱一種事件來電、通話狀態、註冊結束,各自建立訂閱。
需要的編號都要帶註冊編號;通話狀態另外要帶通話編號。
WebRTC 事件訂閱:運作原理
- 建立訂閱App 送出 registrationId、接收通知的網址(sink)與一種事件類型。
- 等待事件電信留意這個註冊的來電與通話變化。
- 推送通知事件發生時,電信以 CloudEvents 格式把事件送到 sink。
WebRTC 事件訂閱:API 規格
規格名稱
WebRTC Events(CAMARA 開源規格)
呼叫方式
POST /subscriptions 建立;GET /subscriptions 列出;GET/DELETE /subscriptions/{subscriptionId} 查詢或刪除輸入
protocol(HTTP)、sink、types(一種事件類型),以及 config.subscriptionDetail.registrationId;訂閱通話狀態時另帶 sessionId事件
可訂閱 session-invitation 來電、session-status 通話狀態、registration-ends 註冊結束;訂閱結束時另會自動送出 subscription-ended
典型用途
App 內建網路電話,接收來電與通話狀態
| 事件內容 | 意思 | 範例 |
|---|---|---|
| session-invitation | 有新的來電,附上來電號碼與通話編號 | …v0.session-invitation |
| session-status | 通話狀態改變,附上最新狀態 | Hold |
| registration-ends | 註冊結束,原因為 REGISTRATION_EXPIRED 或 NETWORK_TERMINATED | REGISTRATION_EXPIRED |
三個情境的回覆內容(節錄)
A有人來電
type
org.camaraproject.webrtc-events.v0.session-invitation來電邀請data.originatorAddress
tel:+886911222333來電號碼B通話狀態改變
type
org.camaraproject.webrtc-events.v0.session-status通話狀態更新data.status
Hold對方保留通話C註冊結束
type
org.camaraproject.webrtc-events.v0.registration-ends註冊結束data.terminationReason
REGISTRATION_EXPIRED註冊到期規格來源:CAMARA WebRTC r2.2(WebRTC Events v0.2.0)
WebRTC 事件訂閱:GSMA 應用情境
提升通話體驗Enhanced call experiences
醫療公共服務服務大量客戶的各產業
要解決的問題讓任何連網裝置(有沒有 SIM 卡都可以)透過電信網路通話。
WebRTC 事件訂閱的角色訂閱事件,接收來電請求。
一起使用:WebRTC 註冊、WebRTC 通話處理
GSMA 原文 ↗資料來源:GSMA Open Gateway Use Case Library 與 API Descriptions(2026-10-14 讀取),中文為摘要翻譯。