@spatius/avatarkit 1.3.9 → 1.3.10-beta.1

package/dist/index.js

@@ -1,4 +1,4 @@
-import { $ as DEFAULT_REGION, A as fetchBootstrap, B as OTEL_STREAM_NAME, C as cleanupOtel, D as monoTimestamp, E as monoMarkFrom, F as recordMetric, G as generateTraceId, H as logger, I as getSdkPackage, J as AvatarError, K as logSink, L as resolveSdkVersion, M as cleanupOtelMetrics, N as initializeOtelMetrics, O as resolveMarks, P as recordHttpClientDuration, Q as DEFAULT_OPUS_BITRATE, S as updatePostHogPersonPropertiesForFlags, U as setLogLevel, V as isDebugMode, W as idManager, X as ConnectionState, Y as AvatarState, Z as ConversationState, _ as getLogsFeatureFlag, a as startLoadTrace, at as LogLevel, b as logMetric, c as AudioFormat, ct as TransitionType, d as MessageType, dt as __commonJSMin, et as DEFAULT_REGION_REQUEST, f as TransportCompression, ft as __toESM, g as clientContextFields, h as cleanupPostHog, i as startInitTrace, it as LoadProgress, j as hostOf, k as clockSync, l as EgressType, lt as requireSDK, m as BinaryWriter, n as initializeOtelTrace, nt as ErrorCode, o as startPlaybackTrace, ot as RENDER_QUALITY_PARAMS, p as BinaryReader, q as AnimationType, r as startConnectTrace, rt as FrameStarvationMode, s as buildTraceparent, st as RenderQuality, t as cleanupOtelTrace, tt as DrivingServiceMode, u as Message, ut as setSDKRef, v as initializePostHog, w as initializeOtel, x as logMetricDetail, y as logEvent, z as OTEL_LOGS_ENDPOINT } from "./otel-trace-DqXSWBaw.js";
+import { $ as FrameStarvationMode, A as recordHttpClientDuration, B as idManager, C as monoTimestamp, D as hostOf, E as fetchBootstrap, F as getSdkPackage, G as ConnectionState, H as AnimationType, I as resolveSdkVersion, J as DEFAULT_OPUS_BITRATE, K as ConversationState, M as OTEL_LOGS_ENDPOINT, N as OTEL_STREAM_NAME, O as cleanupOtelMetrics, P as isDebugMode, Q as ErrorCode, R as logger, S as monoMarkFrom, T as clockSync, U as AvatarError, V as generateTraceId, W as AvatarState, X as DEFAULT_REGION_REQUEST, Y as DEFAULT_REGION, Z as DrivingServiceMode, _ as logMetric, a as startLoadTrace, at as TransitionType, b as initializeOtel, c as AudioFormat, ct as __commonJSMin, d as MessageType, et as LoadProgress, f as TransportCompression, g as logEvent, h as clientContextFields, i as startInitTrace, it as SUPPORTED_SAMPLE_RATES, j as recordMetric, k as initializeOtelMetrics, l as EgressType, lt as __toESM, m as BinaryWriter, n as initializeOtelTrace, nt as RENDER_QUALITY_PARAMS, o as startPlaybackTrace, ot as requireSDK, p as BinaryReader, q as DEFAULT_AUDIO_FORMAT, r as startConnectTrace, rt as RenderQuality, s as buildTraceparent, st as setSDKRef, t as cleanupOtelTrace, tt as LogLevel, u as Message, v as logMetricDetail, w as resolveMarks, y as cleanupOtel, z as setLogLevel } from "./otel-trace-CjdZ3saJ.js";
 //#region core/Avatar.ts
 var Avatar = class {
 	id;
@@ -41893,7 +41893,7 @@ var OpusDecoderProxy = class OpusDecoderProxy {
 			try {
 				worker = new Worker(new URL(
 					/* @vite-ignore */
-					"" + new URL("assets/OpusDecoderWorker.worker-DWI3dYQC.js", import.meta.url).href,
+					"" + new URL("assets/OpusDecoderWorker.worker-6yl1qL0f.js", import.meta.url).href,
 					"" + import.meta.url
 				), { type: "module" });
 			} catch (err) {
@@ -42892,9 +42892,8 @@ var AnimationPlayer = class AnimationPlayer {
 	* Called when service connection is established
 	* @internal
 	*/
-	async createAndInitializeStreamingPlayer() {
+	async createAndInitializeStreamingPlayer(audioFormat) {
 		if (this.streamingPlayer) return;
-		const audioFormat = requireSDK().getAudioFormat();
 		this.streamingPlayer = new StreamingAudioPlayer({
 			sampleRate: audioFormat.sampleRate,
 			channelCount: audioFormat.channelCount,
@@ -42915,8 +42914,8 @@ var AnimationPlayer = class AnimationPlayer {
 	* Stop previous playback and update end callback
 	* @internal
 	*/
-	async prepareStreamingPlayer(onEnded) {
-		if (!this.streamingPlayer) await this.createAndInitializeStreamingPlayer();
+	async prepareStreamingPlayer(onEnded, audioFormat) {
+		if (!this.streamingPlayer) await this.createAndInitializeStreamingPlayer(audioFormat);
 		if (!this.streamingPlayer) throw new Error("Failed to create streaming player");
 		this.streamingPlayer.stop();
 		this.onEndedCallback = onEnded;
@@ -44445,7 +44444,7 @@ function emitInitErrorLog(params) {
 * 这里直接 `fetch(keepalive)`，浏览器保证请求在页面卸载后仍会完成（≤64KB）。
 *
 * 带上常规通道会自动注入的关联键（client_id / session_id / connection_id）和客户端环境
-* 字段，后台按同样的字段名查。不进 PostHog。
+* 字段，后台按同样的字段名查。
 * @internal
 */
 function emitDirectLog(event, level, contents, ctx) {
@@ -45893,17 +45892,11 @@ async function probe() {
 //#endregion
 //#region core/AvatarSDK.ts
 /** PCM 输入 + Opus 上行时受支持的采样率（Opus 编码器可用的采样率）。 */
-var OPUS_UPLINK_SAMPLE_RATES = [
-	8e3,
-	16e3,
-	24e3,
-	48e3
-];
 var AvatarSDK = class {
 	static _initializationState = "uninitialized";
 	static _initializingPromise = null;
 	static _configuration = null;
-	static _version = "1.3.9";
+	static _version = "1.3.10-beta.1";
 	static _avatarCore = null;
 	static _cachedDeviceScore = null;
 	static _rendererBackend = null;
@@ -45971,26 +45964,7 @@ var AvatarSDK = class {
 				...configuration,
 				region
 			};
-			const af = this._configuration.audioFormat;
-			if (af && af.opusUplinkEnabled !== false && af.inputAudioFormat !== "opus" && !OPUS_UPLINK_SAMPLE_RATES.includes(af.sampleRate)) {
-				logger.warn(`[AvatarSDK] Opus uplink is on but sampleRate=${af.sampleRate} is not Opus-compatible (supported: ${OPUS_UPLINK_SAMPLE_RATES}); disabling Opus uplink, sending raw PCM.`);
-				this._configuration = {
-					...this._configuration,
-					audioFormat: {
-						...af,
-						opusUplinkEnabled: false
-					}
-				};
-				logEvent("opus_uplink_disabled_unsupported_rate", "warning", {
-					sample_rate: af.sampleRate,
-					supported_rates: OPUS_UPLINK_SAMPLE_RATES.join(",")
-				});
-			}
 			const regionEnd = Date.now();
-			initializePostHog(this._version, {
-				region,
-				dsm
-			});
 			initializeOtel(this._version, {
 				region,
 				dsm,
@@ -46039,9 +46013,6 @@ var AvatarSDK = class {
 					gpu_renderer: cap.gpuRenderer
 				});
 			}).catch(() => {});
-			setTimeout(() => {
-				this.flushLogsIfNeeded().catch(() => {});
-			}, 0);
 		} catch (error) {
 			const errorMessage = error instanceof Error ? error.message : String(error);
 			try {
@@ -46130,7 +46101,6 @@ var AvatarSDK = class {
 	*/
 	static setUserId(userId) {
 		idManager.setUserId(userId);
-		updatePostHogPersonPropertiesForFlags();
 	}
 	/** @internal */
 	static get isInitialized() {
@@ -46178,21 +46148,6 @@ var AvatarSDK = class {
 		return this._configuration?.drivingServiceMode ?? DrivingServiceMode.direct;
 	}
 	/**
-	* 获取音频格式配置（带默认值）
-	* @internal
-	*/
-	static getAudioFormat() {
-		const format = this._configuration?.audioFormat ?? {
-			channelCount: 1,
-			sampleRate: 16e3
-		};
-		if (format.inputAudioFormat === "opus" && format.sampleRate !== 48e3) return {
-			...format,
-			sampleRate: 48e3
-		};
-		return format;
-	}
-	/**
 	* 获取AvatarCore实例（仅供 SDK 内部使用）
 	* @internal
 	*/
@@ -46213,21 +46168,6 @@ var AvatarSDK = class {
 		};
 	}
 	/**
-	* Override the audio format after init. Used by the Opus integration cases to
-	* flip `inputAudioFormat` between 'pcm' and 'opus' without a full cleanup +
-	* init cycle (the format is otherwise fixed at initialize() time, and the
-	* runner initializes once for the whole suite). Pass undefined to restore the
-	* default PCM format. Throws if SDK isn't initialized.
-	* @internal Test-only SPI; aligned with iOS/Android `setAudioFormatForTesting`.
-	*/
-	static setAudioFormatForTesting(format) {
-		if (!this._configuration) throw new Error("[AvatarSDK] setAudioFormatForTesting: SDK not initialized");
-		this._configuration = {
-			...this._configuration,
-			audioFormat: format
-		};
-	}
-	/**
 	* Count keyframes in a raw `Message` payload (as captured via
 	* `AvatarController.onRawAnimationData`). Useful for validating that a
 	* test fixture decoded correctly. Returns 0 on decode failure.
@@ -46328,7 +46268,6 @@ var AvatarSDK = class {
 			this._initializationState = "uninitialized";
 			this._initializingPromise = null;
 			idManager.clear();
-			cleanupPostHog();
 			cleanupOtel();
 			cleanupOtelMetrics();
 			cleanupOtelTrace();
@@ -46355,20 +46294,6 @@ var AvatarSDK = class {
 		};
 	}
 	/**
-	* Flush logs if feature flag is enabled (private method)
-	* First fetches latest feature flag from server, then decides whether to upload logs
-	* @internal
-	*/
-	static async flushLogsIfNeeded() {
-		try {
-			if (!await getLogsFeatureFlag()) return;
-			await logSink.flush();
-		} catch (error) {
-			const errorMessage = error instanceof Error ? error.message : String(error);
-			logger.warn("[AvatarSDK] Failed to flush logs:", errorMessage);
-		}
-	}
-	/**
 	* Device performance score (CPU + GPU).
 	* CPU: matrix multiply throughput in Web Worker (warmup 1s + measure 1s).
 	* GPU: WebGPU compute shader throughput (warmup 1s + measure 1s).
@@ -46387,7 +46312,7 @@ var AvatarSDK = class {
 	static GPU_SCORE_THRESHOLD = 100;
 	/**
 	* Check if the current device can run the avatar.
-	* Runs a ~2s benchmark, reports device info and scores to PostHog.
+	* Runs a ~2s benchmark, reports device info and scores via telemetry.
 	* Returns false when neither WebGL2 nor WebGPU can be created — that is deterministic
 	* and the benchmark is skipped. Otherwise runs the benchmark and returns true; the
 	* score thresholds are not yet enforced and will be calibrated from production data.
@@ -46543,7 +46468,7 @@ var OpusEncoderProxy = class OpusEncoderProxy {
 			try {
 				worker = new Worker(new URL(
 					/* @vite-ignore */
-					"" + new URL("assets/OpusEncoderWorker.worker-BlkaRHli.js", import.meta.url).href,
+					"" + new URL("assets/OpusEncoderWorker.worker-BTGeizmj.js", import.meta.url).href,
 					"" + import.meta.url
 				), { type: "module" });
 			} catch (err) {
@@ -46823,8 +46748,47 @@ var AnimationWebSocketClient = class extends EventEmitter {
 	* for the rationale and conversation-boundary handling.
 	*/
 	pendingAudioBuffer = new PendingAudioBuffer();
+	/**
+	* 本轮 ws 上行写入计数：分母 = 调用了几次 ws.send()，分子 = 其中抛异常的次数。
+	* 统计的是**写 socket 这个动作**本身的成败，不掺宿主时序、降级或服务端处理。
+	*
+	* 必须记在这一层：一次 send() 对 ws.send() 不是一对一。PCM 路径一对一，而 Opus 的
+	* 编码 / 转发两条路径都按 Ogg page 拆，一次调用可能写 socket 多次，所以调用层的
+	* send_audio_N span 数当不了分母。
+	*/
+	wsSendStats = {
+		total: 0,
+		failed: 0
+	};
+	/**
+	* 已就哪一轮发过 `audioSendDropped`。一次断连会让本轮**剩下的每一页**都发不出去，
+	* 而降级只需要通知一次：后续通知既是 no-op（controller 已在降级态），又会因为这些页
+	* 往往属于刚结束的那一轮而撞上 cid 校验，每页刷一条 `keyframes_conversation_id_mismatch`
+	* 告警。故按 req_id 去重，与 `tracedReqId` 的 set-once 模式一致。
+	*/
+	droppedNotifiedReqId = null;
+	/** 通知本轮上行已失败（需要降级），同一轮只发一次。 */
+	notifyAudioSendDropped(conversationId) {
+		if (!conversationId || this.droppedNotifiedReqId === conversationId) return;
+		this.droppedNotifiedReqId = conversationId;
+		this.emit("audioSendDropped", conversationId);
+	}
+	/** 取本轮 ws 上行计数快照，供轮次级上报。 @internal */
+	getWsSendStats() {
+		return { ...this.wsSendStats };
+	}
+	/** 轮次结束、上报完毕后清零。 @internal */
+	resetWsSendStats() {
+		this.wsSendStats = {
+			total: 0,
+			failed: 0
+		};
+	}
+	/** 取本 view 当前生效的音频格式（见 options 注释）。 */
+	getAudioFormat;
 	constructor(options) {
 		super();
+		this.getAudioFormat = options.getAudioFormat;
 		this.wsUrl = options.wsUrl;
 		this.jwtToken = options.jwtToken;
 		this.appId = options.appId;
@@ -46848,6 +46812,7 @@ var AnimationWebSocketClient = class extends EventEmitter {
 			this.currentCharacterId = characterId;
 			this.sessionConfigured = false;
 			this.tracedReqId = null;
+			this.droppedNotifiedReqId = null;
 			await this.ensureOpusEncoder();
 			idManager.generateConnectionId();
 			const url = this.buildWebSocketUrl(characterId);
@@ -46941,9 +46906,11 @@ var AnimationWebSocketClient = class extends EventEmitter {
 			const writer = new BinaryWriter();
 			Message.encode(message, writer);
 			const bytes = writer.finish();
+			this.wsSendStats.total++;
 			this.ws.send(bytes);
 			return true;
 		} catch (error) {
+			this.wsSendStats.failed++;
 			const message = error instanceof Error ? error.message : String(error);
 			logger.error("[AnimationWebSocketClient] Failed to send audio data:", message);
 			logEvent("send_audio_failed", "error", {
@@ -46993,6 +46960,7 @@ var AnimationWebSocketClient = class extends EventEmitter {
 				};
 				const writer = new BinaryWriter();
 				Message.encode(message, writer);
+				this.wsSendStats.total++;
 				this.ws.send(writer.finish());
 			};
 			for (let i = 0; i < pages.length; i++) sendOne(pages[i], end && i === pages.length - 1);
@@ -47003,6 +46971,7 @@ var AnimationWebSocketClient = class extends EventEmitter {
 			}
 			return true;
 		} catch (error) {
+			this.wsSendStats.failed++;
 			const message = error instanceof Error ? error.message : String(error);
 			logger.error("[AnimationWebSocketClient] Failed to forward Opus audio:", message);
 			logEvent("send_audio_failed", "error", {
@@ -47025,7 +46994,7 @@ var AnimationWebSocketClient = class extends EventEmitter {
 	*/
 	/** 1 秒 PCM 的字节数（16-bit 单声道），用于把编码分段按音频秒数切开。 */
 	get audioBytesPerSecond() {
-		return (AvatarSDK.getAudioFormat().sampleRate || 16e3) * 2;
+		return (this.getAudioFormat().sampleRate || 16e3) * 2;
 	}
 	/**
 	* 编码 span 的跨**调用**累计状态（不足 1 秒的余量留到下一次 encode 调用）。
@@ -47075,7 +47044,10 @@ var AnimationWebSocketClient = class extends EventEmitter {
 				pendingTs = ts;
 			});
 			const sendPage = (page, isLast) => {
-				if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return;
+				if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+					this.notifyAudioSendDropped(conversationId);
+					return;
+				}
 				const message = {
 					type: MessageType.MESSAGE_CLIENT_AUDIO_INPUT,
 					clientAudioInput: {
@@ -47087,6 +47059,7 @@ var AnimationWebSocketClient = class extends EventEmitter {
 				};
 				const writer = new BinaryWriter();
 				Message.encode(message, writer);
+				this.wsSendStats.total++;
 				this.ws.send(writer.finish());
 			};
 			let held = null;
@@ -47102,6 +47075,7 @@ var AnimationWebSocketClient = class extends EventEmitter {
 			if (held === null && end) held = /* @__PURE__ */ new Uint8Array(0);
 			if (held) sendPage(held, end);
 		} catch (error) {
+			this.wsSendStats.failed++;
 			const message = error instanceof Error ? error.message : String(error);
 			logger.error("[AnimationWebSocketClient] Failed to send Opus audio:", message);
 			logEvent("send_audio_failed", "error", {
@@ -47110,6 +47084,7 @@ var AnimationWebSocketClient = class extends EventEmitter {
 				description: message,
 				format: "opus"
 			});
+			this.notifyAudioSendDropped(conversationId);
 			this.emit("error", error);
 		}
 	}
@@ -47127,7 +47102,7 @@ var AnimationWebSocketClient = class extends EventEmitter {
 	* environment that can't do Opus).
 	*/
 	shouldUseOpusUplink() {
-		const { opusUplinkEnabled } = AvatarSDK.getAudioFormat();
+		const { opusUplinkEnabled } = this.getAudioFormat();
 		if (opusUplinkEnabled === false) return false;
 		return true;
 	}
@@ -47144,7 +47119,7 @@ var AnimationWebSocketClient = class extends EventEmitter {
 	*    the connection.
 	*/
 	async ensureOpusEncoder() {
-		const { sampleRate, opusBitrate, inputAudioFormat } = AvatarSDK.getAudioFormat();
+		const { sampleRate, opusBitrate, inputAudioFormat } = this.getAudioFormat();
 		if (this.opusEncoder) {
 			this.opusEncoder.destroy();
 			this.opusEncoder = null;
@@ -47415,7 +47390,7 @@ var AnimationWebSocketClient = class extends EventEmitter {
 			return;
 		}
 		try {
-			const audioFormatConfig = AvatarSDK.getAudioFormat();
+			const audioFormatConfig = this.getAudioFormat();
 			const audioFormat = this.uplinkIsOpus ? AudioFormat.AUDIO_FORMAT_OGG_OPUS : AudioFormat.AUDIO_FORMAT_PCM_S16LE;
 			const bitrate = this.opusEncoder ? audioFormatConfig.opusBitrate ?? 48e3 : 0;
 			const message = {
@@ -47522,7 +47497,8 @@ var NetworkLayer = class {
 			wsUrl: config.driveningressWsUrl,
 			jwtToken: AvatarSDK.sessionToken || void 0,
 			appId: AvatarSDK.appId || void 0,
-			clientId: idManager.getClientId()
+			clientId: idManager.getClientId(),
+			getAudioFormat: () => this.dataController.audioFormat
 		});
 		this.setupWebSocketListeners();
 		this.startHeartbeatCheck();
@@ -47600,9 +47576,29 @@ var NetworkLayer = class {
 			return;
 		}
 	}
+	/** 取本轮 ws 上行写入计数快照，供 playback_quality 上报。 @internal */
+	getWsSendStats() {
+		return this.wsClient.getWsSendStats();
+	}
+	/** 轮次上报完毕后清零。 @internal */
+	resetWsSendStats() {
+		this.wsClient.resetWsSendStats();
+	}
 	/**
 	* 断开连接
 	*/
+	/**
+	* 主动断连（宿主 close / setAudioFormat / view 销毁都走这里）。
+	*
+	* **通知宿主的责任在这里，不在调用方。** 下面先摘掉 wsClient 的全部监听器再关 socket，
+	* 所以 onclose 不会再经 'disconnected' 监听器转成 onConnectionState——这一句只能由本方法
+	* 自己补。曾经是每个调用方各补各的：close() 补了、setSampleRate 忘了，宿主看到的状态停在
+	* connected 而 socket 早已不在。收拢之后调用方只管调 disconnect()。
+	*
+	* **每次调用都通知**，没连过也发：这是 close() 一直以来的契约（集成用例「Double close」
+	* 锁着它：两次 close 两条 disconnected），Android 的 NetworkLayer.close() 也是无条件发。
+	* iOS 对同状态去重是那一端 didSet 的实现细节，不作为 web 的口径。
+	*/
 	disconnect() {
 		this.isFallbackMode = false;
 		this._fallbackReason = "";
@@ -47611,6 +47607,8 @@ var NetworkLayer = class {
 		this.wsClient.disconnect();
 		this.stopHeartbeatCheck();
 		idManager.clearConnectionId();
+		this.dataController.setConnected(false);
+		this.dataController.onConnectionState?.(ConnectionState.disconnected);
 	}
 	/**
 	* 设置 WebSocket 事件监听器
@@ -47638,6 +47636,11 @@ var NetworkLayer = class {
 			this.connectionStartTime = null;
 			this.dataController.onConnectionState?.(ConnectionState.disconnected);
 		});
+		this.wsClient.on("audioSendDropped", (conversationId) => {
+			if (!conversationId) return;
+			this._fallbackReason = "send_failed";
+			this.dataController.yieldKeyframes([], conversationId);
+		});
 		this.wsClient.on("error", (error) => {
 			const message = error instanceof Error ? error.message : String(error);
 			logger.error("[NetworkLayer] WebSocket error:", message);
@@ -47990,22 +47993,95 @@ var FrameRateMonitor = class {
 * Responsible for audio playback and animation rendering synchronization
 * Automatically decides whether to compose network layer based on configuration
 */
-/** 用户经 `send()` 喂入 SDK 的音频格式（config.inputAudioFormat）。session 级、init 写死。 */
-function resolveInputAudioFormat() {
-	return AvatarSDK.getAudioFormat().inputAudioFormat === "opus" ? "opus" : "pcm";
+/** PCM 输入 + Opus 上行时，Opus 编码器支持的采样率。 */
+var OPUS_UPLINK_SAMPLE_RATES = [
+	8e3,
+	16e3,
+	24e3,
+	48e3
+];
+/**
+* 把宿主给的音频格式规范化成 SDK 内部实际生效的那一份。两条规则原先分散在
+* `AvatarSDK.getAudioFormat()`（每次读都算一遍）和 `initialize()`（只在 init 时校验一次），
+* 音频格式下放到 view 之后收在这里，构造与 setter 共用同一份判断。
+*
+* 1. **Opus 输入归一化到 48 kHz**：合规的 Ogg Opus 一律解码成 48 kHz，宿主传的 `sampleRate`
+*    是 PCM 输入才有的概念。不归一化的话，解码器、播放链路、以及 SDK 向服务端声明的会话
+*    配置会各自看到一个不真实的采样率。
+* 2. **Opus 上行采样率不兼容则关掉 Opus 上行**：编码器只支持 8k/16k/24k/48k，其余值会让
+*    编码器建不起来后静默降级成 PCM——宿主以为在用 Opus，实际发的是 PCM。这里显式关掉并
+*    告警，让降级可见。Opus 输入不受此限（已归一化到 48k）。
+*/
+function normalizeAudioFormat(format) {
+	let out = format;
+	if (out.inputAudioFormat === "opus" && out.sampleRate !== 48e3) out = {
+		...out,
+		sampleRate: 48e3
+	};
+	if (out.opusUplinkEnabled !== false && out.inputAudioFormat !== "opus" && !OPUS_UPLINK_SAMPLE_RATES.includes(out.sampleRate)) {
+		logger.warn(`[AvatarController] Opus uplink is on but sampleRate=${out.sampleRate} is not Opus-compatible (supported: ${OPUS_UPLINK_SAMPLE_RATES}); disabling Opus uplink, sending raw PCM.`);
+		logEvent("opus_uplink_disabled_unsupported_rate", "warning", {
+			sample_rate: out.sampleRate,
+			supported_rates: OPUS_UPLINK_SAMPLE_RATES.join(",")
+		});
+		out = {
+			...out,
+			opusUplinkEnabled: false
+		};
+	}
+	return out;
+}
+/**
+* 宿主要求的格式里唯一一条「写死」的规则：Opus 输入下采样率恒为解码后的 48 kHz，宿主传的
+* 其它值没有意义，直接改写——不进 normalize（那是可逆的生效规则），而是改写要求本身，
+* 与 Android / iOS 在 `AudioFormat` 构造里做的事一致。
+*/
+function coerceRequestedAudioFormat(format) {
+	return format.inputAudioFormat === "opus" && format.sampleRate !== 48e3 ? {
+		...format,
+		sampleRate: 48e3
+	} : format;
+}
+function sameAudioFormat(a, b) {
+	return a.sampleRate === b.sampleRate && (a.opusBitrate ?? 48e3) === (b.opusBitrate ?? 48e3) && a.opusUplinkEnabled !== false === (b.opusUplinkEnabled !== false) && (a.inputAudioFormat ?? "pcm") === (b.inputAudioFormat ?? "pcm");
+}
+/** 用户经 `send()` 喂入 SDK 的音频格式（view 的 inputAudioFormat）。view 级，可经 setAudioFormat 改。 */
+function resolveInputAudioFormat(fmt) {
+	return fmt.inputAudioFormat === "opus" ? "opus" : "pcm";
 }
 /**
 * SDK 实际发往驱动服务的线上音频格式。opus 输入原样转发为 opus；PCM 输入在 opusUplinkEnabled
-* 时被 SDK 编码成 opus（采样率已由 SDK 初始化校验保证兼容，不兼容会在 init 时降级为 PCM）。
-* 纯 config 推导（session 级、init 写死）。
+* 时被 SDK 编码成 opus（采样率兼容性由 normalizeAudioFormat 保证，不兼容会降级为 PCM）。
 */
-function resolveUplinkAudioFormat() {
-	const fmt = AvatarSDK.getAudioFormat();
+function resolveUplinkAudioFormat(fmt) {
 	return fmt.inputAudioFormat === "opus" || fmt.opusUplinkEnabled !== false ? "opus" : "pcm";
 }
 var AvatarController = class {
 	networkLayer;
 	playbackMode;
+	/**
+	* 宿主**要求**的音频格式：构造时传入的值，之后由 {@link setAudioFormat} 逐字段合并。
+	* 与 `_audioFormat` 分开存，是为了让规范化可逆：22050 + Opus 上行会被规范化成
+	* 「Opus 上行关」，之后把采样率改回 16000 时上行应当自动恢复——只存规范化后的值就找
+	* 不回宿主原本要的 `opusUplinkEnabled: true` 了。唯一不可逆的一条：切到 Opus 输入时
+	* 采样率写死 48000（与 Android / iOS 的 `AudioFormat` 构造语义一致，三端同形）。
+	*/
+	_requestedAudioFormat;
+	/**
+	* 本 view 生效的音频格式（已规范化）。**不是全局的**：同一页面里两个 view 可以跑不同
+	* 采样率。构造时定下，之后任一字段都可经 {@link setAudioFormat} 改。
+	*/
+	_audioFormat;
+	/**
+	* 本 view 生效的音频格式（已规范化）。只读——改格式走 {@link setAudioFormat}。
+	*
+	* 对外可读，与 iOS `AvatarController.audioFormat` / Android `AvatarController.audioFormat`
+	* 对齐：宿主传进去的值会被规范化（Opus 输入归一到 48 kHz、不兼容的 Opus 上行采样率会关掉
+	* Opus 上行），读回来才能确认实际生效的是什么。
+	*/
+	get audioFormat() {
+		return this._audioFormat;
+	}
 	/** @internal */
 	avatar;
 	/** @internal */
@@ -48169,15 +48245,17 @@ var AvatarController = class {
 	/**
 	* 音频字节率（bytes/s），按 **实际配置的采样率** 动态计算，而不是写死 16kHz。
 	* SDK 支持 8k/16k/22.05k/24k/32k/44.1k/48k，写死会让非 16k 的时长统计整体缩放出错。
-	* Opus 输入已被 AvatarSDK.getAudioFormat() 归一化成 48000，正是解码后 PCM 的真实采样率。
+	* Opus 输入已被 normalizeAudioFormat 归一化成 48000，正是解码后 PCM 的真实采样率。
 	*/
 	get audioBytesPerSecond() {
-		const { sampleRate } = AvatarSDK.getAudioFormat();
+		const { sampleRate } = this._audioFormat;
 		return sampleRate * 1 * 2;
 	}
 	constructor(avatar, options) {
 		this.avatar = avatar;
 		this.playbackMode = options?.playbackMode ?? DrivingServiceMode.direct;
+		this._requestedAudioFormat = coerceRequestedAudioFormat(options?.audioFormat ?? DEFAULT_AUDIO_FORMAT);
+		this._audioFormat = normalizeAudioFormat(this._requestedAudioFormat);
 		if (this.playbackMode === DrivingServiceMode.direct) this.networkLayer = new NetworkLayer(this);
 		if (typeof document !== "undefined") document.addEventListener("visibilitychange", this.handleVisibilityChange);
 		this.ensureInputOpusDecoder();
@@ -48371,13 +48449,18 @@ var AvatarController = class {
 		};
 		if (AvatarSDK.getRendererBackend()) fps.renderer_backend = AvatarSDK.getRendererBackend();
 		const latency = this.getPlaybackLatency();
+		const wsSend = this.networkLayer?.getWsSendStats();
+		const wsSendFields = wsSend && wsSend.total > 0 ? {
+			ws_send_total: wsSend.total,
+			ws_send_failed: wsSend.failed
+		} : {};
 		logEvent("playback_quality", stall.count > 0 || audioStall.count > 0 ? "warning" : "info", {
 			avatar_id: this.avatar.id,
 			conversation_id: this.currentConversationId || void 0,
 			end_reason: this.playbackEndReason,
 			is_fallback: this.isFallbackMode,
-			input_audio_format: resolveInputAudioFormat(),
-			uplink_audio_format: resolveUplinkAudioFormat(),
+			input_audio_format: resolveInputAudioFormat(this._audioFormat),
+			uplink_audio_format: resolveUplinkAudioFormat(this._audioFormat),
 			audio_duration_ms: Math.round(this.receivedAudioBytes / this.audioBytesPerSecond * 1e3),
 			audio_ended: this.reqEnd,
 			animation_frame_count: this.receivedAnimationFrames,
@@ -48385,7 +48468,8 @@ var AvatarController = class {
 			fps: JSON.stringify(fps),
 			stall: JSON.stringify(stall),
 			audio_stall: JSON.stringify(audioStall),
-			...latency ? { latency: JSON.stringify(resolveMarks(latency)) } : {}
+			...latency ? { latency: JSON.stringify(resolveMarks(latency)) } : {},
+			...wsSendFields
 		});
 		this.reportPlaybackMetrics(stats, stall, audioStall, latency);
 		const traceConversationId = this.currentConversationId || "";
@@ -48402,6 +48486,7 @@ var AvatarController = class {
 		this.isFrameStarved = false;
 		this.audioStallEvents = [];
 		this.isAudioBufferStalled = false;
+		this.networkLayer?.resetWsSendStats();
 	}
 	/**
 	* 从 playback_quality 拆出数值指标，各发一个 Histogram（供后台聚合 P95/均值/趋势）。
@@ -48436,14 +48521,19 @@ var AvatarController = class {
 		recordMetric("playback_audio_stall_count", audioStall.count, labels);
 		recordMetric("playback_audio_stall_max_ms", audioStall.max_ms, labels);
 		recordMetric("playback_audio_stall_total_ms", audioStall.total_ms, labels);
+		const wsSendMetrics = this.networkLayer?.getWsSendStats();
+		if (wsSendMetrics && wsSendMetrics.total > 0) {
+			recordMetric("playback_ws_send_total", wsSendMetrics.total, labels);
+			recordMetric("playback_ws_send_failed", wsSendMetrics.failed, labels);
+		}
 		if (latency) {
 			const resolved = resolveMarks(latency);
 			const tap0 = resolved["tap_0"];
 			if (typeof tap0 === "number") {
 				const latencyLabels = {
 					...labels,
-					input_audio_format: resolveInputAudioFormat(),
-					uplink_audio_format: resolveUplinkAudioFormat()
+					input_audio_format: resolveInputAudioFormat(this._audioFormat),
+					uplink_audio_format: resolveUplinkAudioFormat(this._audioFormat)
 				};
 				const emitDelta = (name, key) => {
 					const t = resolved[key];
@@ -48472,8 +48562,8 @@ var AvatarController = class {
 			dsm: this.playbackMode,
 			is_fallback: this.isFallbackMode,
 			end_reason: this.playbackEndReason,
-			input_audio_format: resolveInputAudioFormat(),
-			uplink_audio_format: resolveUplinkAudioFormat()
+			input_audio_format: resolveInputAudioFormat(this._audioFormat),
+			uplink_audio_format: resolveUplinkAudioFormat(this._audioFormat)
 		}, this.serverTraceparent ?? void 0);
 		if (resolved && typeof tap0 === "number") {
 			const actionMarks = {};
@@ -48639,7 +48729,7 @@ var AvatarController = class {
 		if (this.animationPlayer?.isStreamingReady()) return;
 		if (!this.animationPlayer) this.animationPlayer = new AnimationPlayer();
 		if (!this.animationPlayer.isStreamingReady()) try {
-			await this.animationPlayer.createAndInitializeStreamingPlayer();
+			await this.animationPlayer.createAndInitializeStreamingPlayer(this._audioFormat);
 		} catch (error) {
 			const message = error instanceof Error ? error.message : String(error);
 			logger.error("[AvatarController] Failed to initialize audio context:", message);
@@ -48661,7 +48751,7 @@ var AvatarController = class {
 	* into PCM16 for the local audio pipeline.
 	*/
 	async ensureInputOpusDecoder() {
-		const { inputAudioFormat } = AvatarSDK.getAudioFormat();
+		const { inputAudioFormat } = this._audioFormat;
 		if (inputAudioFormat !== "opus" || this.inputOpusDecoderProxy) return;
 		try {
 			this.inputOpusDecoderProxy = await OpusDecoderProxy.create();
@@ -48673,7 +48763,7 @@ var AvatarController = class {
 				stage: "decoder_init",
 				reason: message
 			}, { rateLimit: true });
-			this.onError?.(new AvatarError(`Failed to initialize Opus decoder: ${message}`, ErrorCode.playbackInitFailed));
+			this.emitError(new AvatarError(`Failed to initialize Opus decoder: ${message}`, ErrorCode.playbackInitFailed));
 		}
 	}
 	/**
@@ -48684,7 +48774,7 @@ var AvatarController = class {
 	*/
 	async normalizeInputAudioToPcm(data) {
 		if (!this.inputOpusDecoderProxy) {
-			if (resolveInputAudioFormat() === "opus") {
+			if (resolveInputAudioFormat(this._audioFormat) === "opus") {
 				logger.error("[AvatarController] Opus input but decoder unavailable; dropping chunk to avoid playing raw Opus as PCM");
 				logEvent("opus_input_decode_failed", "error", { stage: "decoder_unavailable" }, { rateLimit: true });
 				return {
@@ -48717,6 +48807,101 @@ var AvatarController = class {
 		}
 	}
 	/**
+	* 改本 view 的音频格式——**部分更新**：传什么改什么，没传的字段保持原状。
+	*
+	* 四个字段走同一条路，不区分「重」「轻」：**打断当前轮次 → 销毁音频上下文 → 写入新格式
+	* → direct 模式断连**。之后喂入的音频按新格式解释；下次 `start()` 时编码器、输入解码器与
+	* 会话配置都按新格式重建。
+	*
+	* - 不设 idle 门禁：「音频已喂进来、动画还在路上、尚未起播」这个中间态既不是 idle 也不在
+	*   播，恰恰必须清干净；interrupt 本就是为此存在的，idle 且无音频时它是空操作。
+	* - **只销毁音频上下文，不重建**：`AudioContext` 的采样率是构造参数、Web Audio 不允许改，
+	*   而重建需要用户手势——那是 SDK 保证不了、只有宿主知道的前提。宿主在自己的手势回调里调
+	*   {@link initializeAudioContext} 重建；在那之前 `send()` 会经 `onError` 报
+	*   `audioContextNotInitialized` 并返回 null，不会静默无声。
+	* - 断连而不自动重连：宿主接下来还要重建上下文，连接由它后续的 `start()` 带起。
+	*
+	* 规则：
+	* - 切到 `inputAudioFormat: 'opus'` 时采样率写死 48000（Opus 解码固定值），传了别的值也
+	*   会被改写。切回 `'pcm'` 时采样率**保持当前值**（可能是 48000）——要换就在同一次调用里
+	*   一起传 `sampleRate`。
+	* - 采样率不兼容 Opus 上行（不是 8k/16k/24k/48k）时 Opus 上行会被关掉；之后把采样率改回
+	*   兼容值，上行按宿主原本的要求自动恢复。
+	* - 传入的值与当前要求完全一致时什么都不做（不打断、不销毁、不断连）。
+	*
+	* **两种非法用法都只记一条 `logger.error` 后原样返回**，不抛异常也不进 `onError`：
+	* 1. `sampleRate` 不在支持列表里（8000 / 16000 / 22050 / 24000 / 32000 / 44100 / 48000）
+	* 2. 在 Opus 输入下传 `sampleRate`（无论是本来就是 Opus 输入，还是这一次一起切过去）
+	*
+	* 都是调用方把代码写错了，不是运行期可恢复的 SDK 故障。走 `onError` 并不更可靠：那是
+	* 可选回调，宿主未必注册、注册了也未必打到控制台；为它们新增 ErrorCode 还会平白扩大
+	* 三端公开错误码面。注释 + 日志 + 文档已经够让写代码的人当场发现。三端一致。
+	*/
+	setAudioFormat(patch) {
+		const current = this._requestedAudioFormat;
+		const merged = {
+			...current,
+			...patch.sampleRate !== void 0 && { sampleRate: patch.sampleRate },
+			...patch.opusBitrate !== void 0 && { opusBitrate: patch.opusBitrate },
+			...patch.opusUplinkEnabled !== void 0 && { opusUplinkEnabled: patch.opusUplinkEnabled },
+			...patch.inputAudioFormat !== void 0 && { inputAudioFormat: patch.inputAudioFormat }
+		};
+		if (patch.sampleRate !== void 0) {
+			if (!SUPPORTED_SAMPLE_RATES.includes(patch.sampleRate)) {
+				logger.error(`[AvatarController] Unsupported sample rate: ${patch.sampleRate}. Supported: ${SUPPORTED_SAMPLE_RATES.join(", ")}`);
+				return;
+			}
+			if (merged.inputAudioFormat === "opus") {
+				logger.error("[AvatarController] sampleRate is not applicable with Opus input: the rate is fixed at 48000 (the Opus decode rate).");
+				return;
+			}
+		}
+		const next = coerceRequestedAudioFormat(merged);
+		if (sameAudioFormat(next, current)) return;
+		const before = this._audioFormat;
+		const after = normalizeAudioFormat(next);
+		logEvent("lifecycle_api_called", "info", {
+			api: "setAudioFormat",
+			avatar_id: this.avatar.id,
+			changed_fields: [
+				"sampleRate",
+				"opusBitrate",
+				"opusUplinkEnabled",
+				"inputAudioFormat"
+			].filter((k) => patch[k] !== void 0 && patch[k] !== current[k]).join(","),
+			from_sample_rate: before.sampleRate,
+			to_sample_rate: after.sampleRate,
+			from_input_audio_format: before.inputAudioFormat ?? "pcm",
+			to_input_audio_format: after.inputAudioFormat ?? "pcm",
+			from_opus_bitrate: before.opusBitrate ?? 48e3,
+			to_opus_bitrate: after.opusBitrate ?? 48e3,
+			from_opus_uplink_enabled: before.opusUplinkEnabled !== false,
+			to_opus_uplink_enabled: after.opusUplinkEnabled !== false,
+			was_playing: this.isPlaying
+		});
+		this.interrupt();
+		this.cleanupPlayers();
+		this._requestedAudioFormat = next;
+		this._audioFormat = after;
+		this.ensureInputOpusDecoder();
+		this.networkLayer?.disconnect();
+	}
+	/**
+	* 把错误交给宿主，同时写一条 `logger.error`。
+	*
+	* **所有 onError 都必须走这里。** 直接调 `this.onError?.()` 的写法曾让 9 个调用点里 7 个
+	* 不打日志：宿主如果没把回调接到 console（demo 的 log() 就只写页面面板），这些错误在
+	* 控制台完全不可见，排查时看起来像「什么都没发生」——一次上下文未初始化的正常拒绝，
+	* 因此被当成功能失效查了很久。
+	*
+	* 日志走 SDK 自己的 logger（受 logLevel 控制），宿主自己再打一条也无妨：重复一行日志的
+	* 代价，远小于一条错误在控制台彻底消失。
+	*/
+	emitError(error) {
+		logger.error(`[AvatarController] ${error.code ?? "error"}: ${error.message}`);
+		this.onError?.(error);
+	}
+	/**
 	* Check if audio context is initialized
 	* @throws AvatarError if audio context is not initialized
 	* @internal
@@ -48749,11 +48934,11 @@ var AvatarController = class {
 		try {
 			this.checkAudioContextInitialized();
 		} catch (error) {
-			this.onError?.(error);
+			this.emitError(error);
 			return null;
 		}
 		if (!this.networkLayer) {
-			this.onError?.(new AvatarError("Network layer not available", ErrorCode.networkLayerNotAvailable));
+			this.emitError(new AvatarError("Network layer not available", ErrorCode.networkLayerNotAvailable));
 			return null;
 		}
 		if (this.reqEnd && this.currentConversationId) if (this.isPlaying) this.interruptForNewRound();
@@ -48767,7 +48952,7 @@ var AvatarController = class {
 		}
 		this.markFirstAudioTap();
 		const sendStartTs = monoTimestamp();
-		const isOpusInput = resolveInputAudioFormat() === "opus";
+		const isOpusInput = resolveInputAudioFormat(this._audioFormat) === "opus";
 		let sendAudioMs = isOpusInput ? 0 : audioData.byteLength / this.audioBytesPerSecond * 1e3;
 		if (isOpusInput) {
 			const normalized = this.opusInputNormalizer.push(this.currentConversationId, new Uint8Array(audioData), end);
@@ -48780,7 +48965,7 @@ var AvatarController = class {
 					reason: normalized.rejection,
 					detected_shape: normalized.shape
 				});
-				this.onError?.(new AvatarError(message, ErrorCode.invalidAudioInput));
+				this.emitError(new AvatarError(message, ErrorCode.invalidAudioInput));
 				return this.currentConversationId;
 			}
 			const granule = oggMaxGranule(normalized.ogg);
@@ -48831,7 +49016,7 @@ var AvatarController = class {
 			this.markAudioTap(sendAudioMs / 1e3 * this.audioBytesPerSecond);
 		} else {
 			this.receivedAudioBytes += audioData.byteLength;
-			if (resolveUplinkAudioFormat() === "opus") this.markFirstAudioTap();
+			if (resolveUplinkAudioFormat(this._audioFormat) === "opus") this.markFirstAudioTap();
 			else this.markAudioTap(audioData.byteLength);
 			this.addAudioChunkToBuffer(new Uint8Array(audioData), end);
 			this.networkLayer.sendAudioData(this.currentConversationId, audioData, end);
@@ -48862,8 +49047,6 @@ var AvatarController = class {
 		if (this.networkLayer) this.networkLayer.disconnect();
 		else this.currentConversationId = null;
 		this.reqEnd = false;
-		this.isConnected = false;
-		this.onConnectionState?.(ConnectionState.disconnected);
 	}
 	/**
 	* Playback existing audio and animation data (host mode)
@@ -48904,7 +49087,7 @@ var AvatarController = class {
 		try {
 			this.checkAudioContextInitialized();
 		} catch (error) {
-			this.onError?.(error);
+			this.emitError(error);
 			return null;
 		}
 		if (this.reqEnd && this.currentConversationId) {
@@ -48923,7 +49106,7 @@ var AvatarController = class {
 			this.clearPlaybackData();
 		}
 		const yieldStartTs = monoTimestamp();
-		const isOpusInput = resolveInputAudioFormat() === "opus";
+		const isOpusInput = resolveInputAudioFormat(this._audioFormat) === "opus";
 		let yieldAudioMs = isOpusInput ? 0 : data.length / this.audioBytesPerSecond * 1e3;
 		if (isLast) this.reqEnd = true;
 		if (isOpusInput) {
@@ -48937,7 +49120,7 @@ var AvatarController = class {
 					reason: normalized.rejection,
 					detected_shape: normalized.shape
 				});
-				this.onError?.(new AvatarError(message, ErrorCode.invalidAudioInput));
+				this.emitError(new AvatarError(message, ErrorCode.invalidAudioInput));
 				return this.currentConversationId;
 			}
 			const granule = oggMaxGranule(normalized.ogg);
@@ -49081,7 +49264,7 @@ var AvatarController = class {
 			try {
 				const { animation: result, avatarIdMismatch } = decodeAnimation(binaryData, this.avatar.id);
 				if (avatarIdMismatch) {
-					this.onError?.(new AvatarError(`Animation data avatar_id mismatch - expected: ${this.avatar.id}`, ErrorCode.avatarIDUnrecognized));
+					this.emitError(new AvatarError(`Animation data avatar_id mismatch - expected: ${this.avatar.id}`, ErrorCode.avatarIDUnrecognized));
 					continue;
 				}
 				if (!result) {
@@ -49158,7 +49341,7 @@ var AvatarController = class {
 				path: "auto",
 				reason: error instanceof Error ? error.message : String(error)
 			}, { rateLimit: true });
-			this.onError?.(new AvatarError("Failed to start playback", ErrorCode.playbackStartFailed));
+			this.emitError(new AvatarError("Failed to start playback", ErrorCode.playbackStartFailed));
 		});
 		this.traceActions.recvs.push({
 			startTs: recvStartTs,
@@ -49471,7 +49654,7 @@ var AvatarController = class {
 			if (!this.animationPlayer) throw new AvatarError("Animation player not initialized", ErrorCode.animationPlayerNotInitialized);
 			await this.animationPlayer.prepareStreamingPlayer(() => {
 				this.onPlaybackEnded();
-			});
+			}, this._audioFormat);
 			this.animationPlayer.onAudioStall((stalled) => {
 				this.trackAudioBufferStall(stalled);
 			});
@@ -49502,7 +49685,7 @@ var AvatarController = class {
 				path: "streaming",
 				reason: message
 			}, { rateLimit: true });
-			this.onError?.(new AvatarError("Failed to start streaming playback", ErrorCode.playbackInitFailed));
+			this.emitError(new AvatarError("Failed to start streaming playback", ErrorCode.playbackInitFailed));
 			this.isPlaying = false;
 			this.isStartingPlayback = false;
 		}
@@ -52232,13 +52415,17 @@ var AvatarView = class AvatarView {
 	* Creates a unified AvatarController, internally composes network layer based on configuration
 	* @param avatar - Avatar instance
 	* @param container - Canvas container element (required)
+	* @param options - Per-view options; see {@link AvatarViewOptions}
 	*/
-	constructor(avatar, container) {
+	constructor(avatar, container, options) {
 		this.avatar = avatar;
 		this.characterId = `${avatar.id}-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
 		if (!AvatarSDK.configuration) throw new Error("AvatarSDK must be initialized before creating AvatarView. Call AvatarSDK.initialize() first.");
 		const playbackMode = AvatarSDK.getPlaybackMode();
-		this.avatarController = new AvatarController(avatar, { playbackMode });
+		this.avatarController = new AvatarController(avatar, {
+			playbackMode,
+			audioFormat: options?.audioFormat
+		});
 		this.avatarController.setRenderCallback(() => {}, null);
 		this.canvas = this.createCanvas(container);
 		avatarViewRegistry.register(this);
@@ -53476,4 +53663,4 @@ var AvatarView = class AvatarView {
 	}
 };
 //#endregion
-export { AnimationType, Avatar, AvatarController, AvatarError, AvatarManager, AvatarSDK, AvatarState, AvatarView, ConnectionState, ConversationState, DEFAULT_OPUS_BITRATE, DEFAULT_REGION, DEFAULT_REGION_REQUEST, DrivingServiceMode, ErrorCode, FrameStarvationMode, LoadProgress, LogLevel, RENDER_QUALITY_PARAMS, RenderQuality, TransitionType };
+export { AnimationType, Avatar, AvatarController, AvatarError, AvatarManager, AvatarSDK, AvatarState, AvatarView, ConnectionState, ConversationState, DEFAULT_AUDIO_FORMAT, DEFAULT_OPUS_BITRATE, DEFAULT_REGION, DEFAULT_REGION_REQUEST, DrivingServiceMode, ErrorCode, FrameStarvationMode, LoadProgress, LogLevel, RENDER_QUALITY_PARAMS, RenderQuality, SUPPORTED_SAMPLE_RATES, TransitionType };