@laplace.live/pixijs-live2d 0.3.0 → 0.4.0

package/dist/index.d.ts

@@ -3698,6 +3698,8 @@ export declare const VOLUME = 0.5;
  * Manages all the sounds.
  */
 export declare class SoundManager {
+  /** Select the speaker used by current and future motion audio and speak() calls. */
+  static setOutputDevice(deviceId: string): Promise<void>;
   /**
    * Audio elements playing or pending to play. Finished audios will be removed automatically.
    */

package/dist/index.js

@@ -3663,17 +3663,33 @@ const VOLUME = .5;
 const SOUND_ALIAS_PREFIX = "live2d-sound-";
 let soundId = 0;
 let pixiSoundPromise;
-const configuredLibraries = /* @__PURE__ */ new WeakSet();
+const configuredLibraries = /* @__PURE__ */ new Set();
+let outputDeviceId = "";
+let outputError = null;
+/** Device changes and first-use routing run in order, so a library never settles on a stale device. */
+let routing = Promise.resolve();
+function queueRouting(task) {
+	const run = routing.then(task);
+	routing = run.catch(() => void 0);
+	return run;
+}
+async function routeContext(context, deviceId) {
+	const routable = context;
+	if (routable.setSinkId) await routable.setSinkId(deviceId);
+	else if (deviceId) throw new Error("Audio output selection is not supported");
+}
 function configureSoundLibrary(library) {
-	if (!configuredLibraries.has(library)) {
+	return queueRouting(async () => {
+		if (configuredLibraries.has(library)) return library;
 		try {
 			library.disableAutoPause = true;
 		} catch (e) {
 			logger.warn(TAG$2, "Failed to disable @pixi/sound auto pause.", e);
 		}
+		if (outputDeviceId) await routeContext(library.context.audioContext, outputDeviceId);
 		configuredLibraries.add(library);
-	}
-	return library;
+		return library;
+	});
 }
 function getGlobalSoundLibrary() {
 	return typeof PIXI !== "undefined" ? PIXI?.sound : void 0;
@@ -3681,11 +3697,12 @@ function getGlobalSoundLibrary() {
 async function resolveSoundLibrary() {
 	const globalLibrary = getGlobalSoundLibrary();
 	if (globalLibrary) return configureSoundLibrary(globalLibrary);
-	pixiSoundPromise ??= import("@pixi/sound").then(({ sound }) => configureSoundLibrary(sound)).catch((e) => {
+	pixiSoundPromise ??= import("@pixi/sound").then(({ sound }) => sound).catch((e) => {
 		logger.warn(TAG$2, "@pixi/sound is not available. Load pixi-sound.js before using motion sounds, speak(), or lip sync.", e);
 		return null;
 	});
-	return pixiSoundPromise;
+	const library = await pixiSoundPromise;
+	return library ? configureSoundLibrary(library) : null;
 }
 function removeSound(library, alias) {
 	try {
@@ -3710,6 +3727,25 @@ function getAudioBuffer(audio) {
 * Manages all the sounds.
 */
 var SoundManager = class SoundManager {
+	/** Select the speaker used by current and future motion audio and speak() calls. */
+	static setOutputDevice(deviceId) {
+		return queueRouting(async () => {
+			const changed = [];
+			try {
+				for (const library of configuredLibraries) {
+					const context = library.context.audioContext;
+					await routeContext(context, deviceId);
+					changed.push(context);
+				}
+				outputDeviceId = deviceId;
+				outputError = null;
+			} catch (error) {
+				outputError = error;
+				await Promise.allSettled(changed.map((context) => routeContext(context, outputDeviceId)));
+				throw error;
+			}
+		});
+	}
 	/**
 	* Audio elements playing or pending to play. Finished audios will be removed automatically.
 	*/
@@ -3740,6 +3776,7 @@ var SoundManager = class SoundManager {
 		let library = null;
 		let alias;
 		try {
+			if (outputError) throw outputError;
 			library = await resolveSoundLibrary();
 			if (!library) throw new Error("@pixi/sound is not available");
 			alias = `${SOUND_ALIAS_PREFIX}${soundId++}`;
@@ -3768,6 +3805,7 @@ var SoundManager = class SoundManager {
 					}
 				});
 			});
+			if (outputError) throw outputError;
 			SoundManager.aliases.set(audio, {
 				alias: soundAlias,
 				library: soundLibrary
@@ -3787,6 +3825,10 @@ var SoundManager = class SoundManager {
 	* @param onFinish - Callback invoked when the playback has finished.
 	*/
 	static play(audio, onFinish) {
+		if (outputError) {
+			SoundManager.dispose(audio);
+			return;
+		}
 		audio.play({
 			singleInstance: true,
 			complete: () => {