C++ reference
C++ API 概覽
跨平台 C++ SDK 是 Linux、嵌入式、桌面封裝以及行動 SDK 的共用原生基礎。
架構與進入點
SDK 在 XSYNC 協定之上實作 BMX 物件模型；BMXClient 管理連線和服務，監聽器介面負責非同步更新。
Reference 導覽
依目前工作選擇最精確的參考頁面。以下項目皆連至本站託管的自動產生 API 文件。
BMXClient說明 BMXClient 的完整 API、參數、回傳值、錯誤與回呼約定。BMXChatService說明 BMXChatService 的完整 API、參數、回傳值、錯誤與回呼約定。BMXRosterService說明 BMXRosterService 的完整 API、參數、回傳值、錯誤與回呼約定。BMXGroupService說明 BMXGroupService 的完整 API、參數、回傳值、錯誤與回呼約定。BMXUserService說明 BMXUserService 的完整 API、參數、回傳值、錯誤與回呼約定。Listener interfaces說明 Listener interfaces 的完整 API、參數、回傳值、錯誤與回呼約定。建議整合流程
- 使用控制台 App ID 完成設定，並在應用程式生命週期內重用單一用戶端實例。
- 在登入前註冊連線、使用者、訊息與群組監聽器，避免遺漏初始同步事件。
- 使用後端簽發的使用者 token 登入；不要把伺服器端 access-token 放入用戶端。
- 依業務領域呼叫服務或管理器，並以非同步回呼更新應用程式狀態。
- 登出或銷毀頁面時移除監聽器，並釋放上傳、下載與語音視訊資源。
使用時需要注意
- API 簽章與識別碼必須保持不變；AI 解說只補充整合語意。
- 先確認物件生命週期、執行緒與非同步回呼，再把結果同步到 UI。
- 若 AI 解說與目前 SDK 簽章衝突，應以簽章和實際版本為準。