网络诊断 API

检测业务服务器、媒体服务器和基础网络连通性。

API 参考

checkBusinessServerConnection()

检测业务服务器连通性。

向课堂 API 活跃域名发送 HEAD 请求，记录往返时延。建议在用户反馈卡顿时主动调用， 与 checkMediaServerConnection / checkNetworkConnection 配合定位故障源。

返回值: Promise<TResult<{ latency: number; }>>

示例:

const r = await classroom.checkBusinessServerConnection();
if (r.ok && r.data.latency > 1000) toast.warn('业务服务器延迟较高');

---

checkMediaServerConnection()

检测媒体服务器（TRTC）连通性。

调用 TRTC SDK 测速，需在 joinClass() 之后调用。

返回值: Promise<TResult<{ latency: number; lost: number; }>>

示例:

const r = await classroom.checkMediaServerConnection();
if (r.ok && (r.data.latency > 300 || r.data.lost > 0.1)) {
  toast.warn('当前媒体网络较差');
}

---

checkNetworkConnection()

检测基础网络联通性。

向公共测速地址发送 HEAD 请求，超时 5 秒。用于"是否能上网"的最基础判断。

返回值: Promise<TResult<boolean>>

示例:

const r = await classroom.checkNetworkConnection();
if (!r.ok) toast.error('当前网络不可用，请检查网络连接');

---