用 Application Profiles 登記的品質門檻訂閱一台裝置。網路滿足這些門檻的能力一改變,電信就主動通知。
A人潮擁擠
電信通知延遲未達門檻
附近人潮擁擠,網路評估延遲無法達到門檻,電信主動通知。
B恢復順暢
電信通知門檻達成
網路評估延遲又能達到門檻,電信再通知一次。
C訂閱到期
電信通知訂閱結束
到了設定的到期時間,訂閱結束並通知原因。
和查詢版的差別查詢版問現在或某個未來時間點;訂閱版在網路評估改變時主動通知。
收到通知後可以申請 QoD 提升連線,或在 App 端調整,例如影片畫質。
連線洞察訂閱:運作原理
- 建立訂閱送出裝置、Application Profiles 的設定檔編號,以及接收通知的網址。
- 等待事件電信持續評估網路能否滿足這些品質門檻。
- 推送通知評估一改變就推送通知,可包含各項門檻能否達成的評估,以及訊號強度、連線技術等補充資訊。
連線洞察訂閱:API 規格
規格名稱
Connectivity Insights Subscriptions(CAMARA 開源規格)
呼叫方式
POST /subscriptions 建立;GET /subscriptions 列出;GET/DELETE /subscriptions/{subscriptionId} 查詢或刪除輸入
protocol(HTTP)、sink、types,以及 config.subscriptionDetail 的裝置 device 與 applicationProfileId,可選應用伺服器 applicationServer事件
network-quality、subscription-ended
典型用途
視訊、雲端遊戲依網路狀況即時調整
| 事件內容 | 意思 | 範例 |
|---|---|---|
| data.packetDelayBudget、data.targetMinDownstreamRate、data.targetMinUpstreamRate、data.packetlossErrorRate、data.jitter | 網路對各項門檻的評估(有回覆的項目):meets the application requirements 或 unable to meet the application requirements | meets the application requirements |
| data.additionalKpis.signalStrength | 訊號強度(可能附上):excellent、good、fair、poor、no signal | good |
| data.additionalKpis.connectivityType | 連線技術(可能附上):5G-SA、5G-NSA、4G、3G | 5G-SA |
| data.terminationReason | 訂閱結束的原因:MAX_EVENTS_REACHED、NETWORK_TERMINATED、SUBSCRIPTION_EXPIRED、ACCESS_TOKEN_EXPIRED、SUBSCRIPTION_DELETED | SUBSCRIPTION_EXPIRED |
三個情境的回覆內容(節錄)
A人潮擁擠
type
org.camaraproject.connectivity-insights-subscriptions.v0.network-quality網路品質事件data.packetDelayBudget
unable to meet the application requirements網路評估:延遲無法達到門檻B恢復順暢
data.packetDelayBudget
meets the application requirements網路評估:延遲可以達到門檻data.additionalKpis.connectivityType
5G-SA連線技術C訂閱到期
type
org.camaraproject.connectivity-insights-subscriptions.v0.subscription-ended訂閱結束data.terminationReason
SUBSCRIPTION_EXPIRED到了訂閱到期時間規格來源:CAMARA ConnectivityInsights r3.2(Connectivity Insights Subscriptions v0.6.0)