@dcl/playground-assets 7.4.10-8392909116.commit-6487246 → 7.4.10-8395171867.commit-71991c9

package/dist/playground/sdk/dcl-sdk.package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dcl/sdk",
   "description": "",
-  "version": "7.4.10-8392909116.commit-6487246",
+  "version": "7.4.10-8395171867.commit-71991c9",
   "author": "Decentraland",
   "dependencies": {
     "@dcl/ecs": "file:../ecs",
@@ -35,5 +35,5 @@
   },
   "types": "./index.d.ts",
   "typings": "./index.d.ts",
-  "commit": "64872460277fc8eeaacd25ac366eb9e22195dec5"
+  "commit": "71991c9ccab33789a2165ce13286406167874755"
 }

package/dist/playground-assets.d.ts

@@ -90,8 +90,32 @@ export declare namespace AppendValueOperation {
  */
 export declare function areConnected(parcels: Coords[]): boolean;
 
-/** @public */
-export declare const AudioSource: LastWriteWinElementSetComponentDefinition<PBAudioSource>;
+export declare const AudioSource: AudioSourceComponentDefinitionExtended;
+
+/**
+ * @public
+ */
+export declare interface AudioSourceComponentDefinitionExtended extends LastWriteWinElementSetComponentDefinition<PBAudioSource> {
+    /**
+     * @public
+     *
+     * Set playing=true the sound `$name`
+     * @param entity - entity with AudioSource component
+     * @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
+     */
+    playSound(entity: Entity, src: string, resetCursor?: boolean): boolean;
+    /**
+     * @public
+     *
+     * Set playing=false all sounds
+     * @param entity - entity with AudioSource component
+     * @param resetCursor - the sound stops at 0 or at the current cursor position
+     * @returns true in successful stopping, false if it doesn't find the AudioSource component
+     */
+    stopSound(entity: Entity, resetCursor?: boolean): boolean;
+}
 
 /** @public */
 export declare const AudioStream: LastWriteWinElementSetComponentDefinition<PBAudioStream>;
@@ -4133,6 +4157,13 @@ export declare namespace PBAnimator {
  * Note that the `audio_clip_url` is not actually a URL, but rather the path of a file bundled with
  * the scene and declared in its manifest. The name was chosen because the URL use-case will
  * eventually be supported.
+ *
+ * `playing=true` when it's previously `playing=true`
+ *  a) if clip is playing and `current_time` is NOT SET, the clip remains in the current `current_time`
+ *  b) if clip is stopped or `current_time` is set, the clip is played from the `current_time` (if set) or from the beginning
+ *
+ * If other property (volume, loop, pitch) is changed while playing, the clip is keep playing with the new properties
+ * Changing `audio_clip_url` while playing stops the current clip and plays the new one (as a new instance)
  */
 /**
  * @public
@@ -4148,6 +4179,10 @@ export declare interface PBAudioSource {
     pitch?: number | undefined;
     /** the clip path as given in the `files` array of the scene's manifest. */
     audioClipUrl: string;
+    /** specifies the current playback time of the clip in seconds (default: 0). */
+    currentTime?: number | undefined;
+    /** whether the audio plays at constant volume across the scene. */
+    global?: boolean | undefined;
 }
 
 /**

package/etc/playground-assets.api.json

@@ -883,12 +883,36 @@
         {
           "kind": "Variable",
           "canonicalReference": "@dcl/playground-assets!AudioSource:var",
-          "docComment": "/**\n * @public\n */\n",
+          "docComment": "",
           "excerptTokens": [
             {
               "kind": "Content",
               "text": "AudioSource: "
             },
+            {
+              "kind": "Reference",
+              "text": "AudioSourceComponentDefinitionExtended",
+              "canonicalReference": "@dcl/playground-assets!AudioSourceComponentDefinitionExtended:interface"
+            }
+          ],
+          "fileUrlPath": "../ecs/dist/index.d.ts",
+          "isReadonly": true,
+          "releaseTag": "Public",
+          "name": "AudioSource",
+          "variableTypeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          }
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@dcl/playground-assets!AudioSourceComponentDefinitionExtended:interface",
+          "docComment": "/**\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface AudioSourceComponentDefinitionExtended extends "
+            },
             {
               "kind": "Reference",
               "text": "LastWriteWinElementSetComponentDefinition",
@@ -906,16 +930,164 @@
             {
               "kind": "Content",
               "text": ">"
+            },
+            {
+              "kind": "Content",
+              "text": " "
             }
           ],
-          "fileUrlPath": "../ecs/dist/components/generated/global.gen.d.ts",
-          "isReadonly": true,
+          "fileUrlPath": "../ecs/dist/components/extended/AudioSource.d.ts",
           "releaseTag": "Public",
-          "name": "AudioSource",
-          "variableTypeTokenRange": {
-            "startIndex": 1,
-            "endIndex": 5
-          }
+          "name": "AudioSourceComponentDefinitionExtended",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@dcl/playground-assets!AudioSourceComponentDefinitionExtended#playSound:member(1)",
+              "docComment": "/**\n * Set playing=true the sound `$name`\n *\n * @param entity - entity with AudioSource component\n *\n * @param src - the path to the sound to play\n *\n * @param resetCursor - the sound starts at 0 or continues from the current cursor position\n *\n * @returns true in successful playing, false if it doesn't find the AudioSource component\n *\n * @public\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "playSound(entity: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Entity",
+                  "canonicalReference": "@dcl/playground-assets!Entity:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", src: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", resetCursor?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 7,
+                "endIndex": 8
+              },
+              "releaseTag": "Public",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "entity",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "src",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "resetCursor",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 5,
+                    "endIndex": 6
+                  },
+                  "isOptional": true
+                }
+              ],
+              "name": "playSound"
+            },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@dcl/playground-assets!AudioSourceComponentDefinitionExtended#stopSound:member(1)",
+              "docComment": "/**\n * Set playing=false all sounds\n *\n * @param entity - entity with AudioSource component\n *\n * @param resetCursor - the sound stops at 0 or at the current cursor position\n *\n * @returns true in successful stopping, false if it doesn't find the AudioSource component\n *\n * @public\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "stopSound(entity: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Entity",
+                  "canonicalReference": "@dcl/playground-assets!Entity:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", resetCursor?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 6
+              },
+              "releaseTag": "Public",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "entity",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "resetCursor",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": true
+                }
+              ],
+              "name": "stopSound"
+            }
+          ],
+          "extendsTokenRanges": [
+            {
+              "startIndex": 1,
+              "endIndex": 5
+            }
+          ]
         },
         {
           "kind": "Variable",
@@ -36194,6 +36366,60 @@
                 "endIndex": 2
               }
             },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@dcl/playground-assets!PBAudioSource#currentTime:member",
+              "docComment": "/**\n * specifies the current playback time of the clip in seconds (default: 0).\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "currentTime?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number | undefined"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "currentTime",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@dcl/playground-assets!PBAudioSource#global:member",
+              "docComment": "/**\n * whether the audio plays at constant volume across the scene.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "global?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean | undefined"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "global",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "@dcl/playground-assets!PBAudioSource#loop:member",

package/etc/playground-assets.api.md

@@ -50,8 +50,16 @@ export namespace AppendValueOperation {
 // @public
 export function areConnected(parcels: Coords[]): boolean;
 
+// Warning: (ae-missing-release-tag) "AudioSource" is part of the package's API, but it is missing a release tag (@alpha, @beta, @public, or @internal)
+//
 // @public (undocumented)
-export const AudioSource: LastWriteWinElementSetComponentDefinition<PBAudioSource>;
+export const AudioSource: AudioSourceComponentDefinitionExtended;
+
+// @public (undocumented)
+export interface AudioSourceComponentDefinitionExtended extends LastWriteWinElementSetComponentDefinition<PBAudioSource> {
+    playSound(entity: Entity, src: string, resetCursor?: boolean): boolean;
+    stopSound(entity: Entity, resetCursor?: boolean): boolean;
+}
 
 // @public (undocumented)
 export const AudioStream: LastWriteWinElementSetComponentDefinition<PBAudioStream>;
@@ -2075,6 +2083,8 @@ export namespace PBAnimator {
 // @public (undocumented)
 export interface PBAudioSource {
     audioClipUrl: string;
+    currentTime?: number | undefined;
+    global?: boolean | undefined;
     loop?: boolean | undefined;
     pitch?: number | undefined;
     playing?: boolean | undefined;

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@dcl/playground-assets",
   "description": "",
-  "version": "7.4.10-8392909116.commit-6487246",
+  "version": "7.4.10-8395171867.commit-71991c9",
   "author": "Decentraland",
   "dependencies": {
-    "@dcl/js-runtime": "7.4.10-8392909116.commit-6487246",
-    "@dcl/sdk": "7.4.10-8392909116.commit-6487246"
+    "@dcl/js-runtime": "7.4.10-8395171867.commit-71991c9",
+    "@dcl/sdk": "7.4.10-8395171867.commit-71991c9"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.33.8"
@@ -32,5 +32,5 @@
   },
   "types": "./dist/index.d.ts",
   "typings": "./dist/index.d.ts",
-  "commit": "64872460277fc8eeaacd25ac366eb9e22195dec5"
+  "commit": "71991c9ccab33789a2165ce13286406167874755"
 }