@xmov/avatar 2.5.0-alpha.1 → 2.5.0-alpha.3

package/package-dist/index.d.ts

@@ -14,6 +14,22 @@ export default class XmovAvatar {
     getStatus: () => AvatarStatus | -1;
     getRenderState: () => RenderState;
     getSessionId: () => string | undefined;
+    /**
+     * 通过当前 TTSA 会话上报自定义埋点（sdk_burial_point）。
+     * 请在 init() 成功且会话连接就绪后调用；未连接、已销毁时忽略，不缓存或补发。
+     * 此方法不等待服务端确认，返回不代表事件已接收或入库；事件名及业务字段需与服务端约定。
+     * 不受 sentry.enabled 或 enableLogger 开关控制；薄客户端模式无本地 TTSA 连接，不发送。
+     *
+     * @param name 自定义事件英文名，建议使用业务前缀，避免与 SDK 内置点位重名。
+     * @param params 可 JSON 序列化的业务字段，默认空对象。可传正数 timestamp（毫秒时间戳），
+     * 未提供时使用当前时间。自定义事件没有预置中文名，event_cn_name 为空值。
+     * appId、env、burial_type、session_id、event_en_name、event_cn_name、device、sdkVersion
+     * 由 SDK 填充，传入同名字段不会覆盖 SDK 的值。请勿传入凭证等敏感信息。
+     * @returns 无返回值，不提供发送结果或服务端确认。
+     * @example
+     * avatar.sendSdkPoint("business_button_click", { button_id: "start" });
+     */
+    sendSdkPoint: (name: string, params?: Record<string, unknown>) => void;
     idle: () => void;
     listen: () => void;
     think: () => void;