@dcl/ecs 7.24.1-27293561585.commit-8c5b5ad → 7.24.1-27386133361.commit-558451f

package/dist/components/extended/AudioSource.d.ts

@@ -8,11 +8,13 @@ export interface AudioSourceComponentDefinitionExtended extends LastWriteWinElem
     /**
      * @public
      *
-     * Set playing=true the sound `$name`
-     * @param entity - entity with AudioSource component
+     * Play the sound `src` on the given entity. Creates the AudioSource component
+     * if it does not yet exist. Always emits a CRDT PUT, so repeated calls with
+     * identical parameters reliably retrigger playback.
+     * @param entity - target entity (AudioSource will be created if missing)
      * @param src - the path to the sound to play
      * @param resetCursor - the sound starts at 0 or continues from the current cursor position
-     * @returns true in successful playing, false if it doesn't find the AudioSource component
+     * @returns always true; retained for backwards compatibility
      */
     playSound(entity: Entity, src: string, resetCursor?: boolean): boolean;
     /**

package/dist/components/extended/AudioSource.js

@@ -4,13 +4,13 @@ export function defineAudioSourceComponent(engine) {
     return {
         ...theComponent,
         playSound(entity, src, resetCursor = true) {
-            // Get the mutable to modify
-            const audioSource = theComponent.getMutableOrNull(entity);
-            if (!audioSource)
-                return false;
-            audioSource.audioClipUrl = src;
-            audioSource.playing = true;
-            audioSource.currentTime = resetCursor ? 0 : audioSource.currentTime;
+            const existing = theComponent.getOrNull(entity);
+            theComponent.createOrReplace(entity, {
+                ...existing,
+                audioClipUrl: src,
+                playing: true,
+                currentTime: resetCursor ? 0 : existing?.currentTime ?? 0
+            });
             return true;
         },
         stopSound(entity, resetCursor = true) {

package/dist-cjs/components/extended/AudioSource.d.ts

@@ -8,11 +8,13 @@ export interface AudioSourceComponentDefinitionExtended extends LastWriteWinElem
     /**
      * @public
      *
-     * Set playing=true the sound `$name`
-     * @param entity - entity with AudioSource component
+     * Play the sound `src` on the given entity. Creates the AudioSource component
+     * if it does not yet exist. Always emits a CRDT PUT, so repeated calls with
+     * identical parameters reliably retrigger playback.
+     * @param entity - target entity (AudioSource will be created if missing)
      * @param src - the path to the sound to play
      * @param resetCursor - the sound starts at 0 or continues from the current cursor position
-     * @returns true in successful playing, false if it doesn't find the AudioSource component
+     * @returns always true; retained for backwards compatibility
      */
     playSound(entity: Entity, src: string, resetCursor?: boolean): boolean;
     /**

package/dist-cjs/components/extended/AudioSource.js

@@ -7,13 +7,13 @@ function defineAudioSourceComponent(engine) {
     return {
         ...theComponent,
         playSound(entity, src, resetCursor = true) {
-            // Get the mutable to modify
-            const audioSource = theComponent.getMutableOrNull(entity);
-            if (!audioSource)
-                return false;
-            audioSource.audioClipUrl = src;
-            audioSource.playing = true;
-            audioSource.currentTime = resetCursor ? 0 : audioSource.currentTime;
+            const existing = theComponent.getOrNull(entity);
+            theComponent.createOrReplace(entity, {
+                ...existing,
+                audioClipUrl: src,
+                playing: true,
+                currentTime: resetCursor ? 0 : existing?.currentTime ?? 0
+            });
             return true;
         },
         stopSound(entity, resetCursor = true) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dcl/ecs",
   "description": "Decentraland ECS",
-  "version": "7.24.1-27293561585.commit-8c5b5ad",
+  "version": "7.24.1-27386133361.commit-558451f",
   "author": "DCL",
   "bugs": "https://github.com/decentraland/ecs/issues",
   "files": [
@@ -34,5 +34,5 @@
   "dependencies": {},
   "types": "./dist/index.d.ts",
   "typings": "./dist/index.d.ts",
-  "commit": "8c5b5ad2e37f5977395ef59bd59b2be061c7a391"
+  "commit": "558451f7deaac1ece95b58a178ab8b291e524479"
 }