Skip to content

Commit be896a9

Browse files
JurfixJurfix
authored
Update AudioByName.json (#2245)
Added actions for playing sound and music without channels.
1 parent 1ba297a commit be896a9

1 file changed

Lines changed: 142 additions & 3 deletions

File tree

‎extensions/community/AudioByName.json‎

Lines changed: 142 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,21 +9,28 @@
99
"name": "AudioByName",
1010
"previewIconUrl": "https://resources.gdevelop-app.com/assets/Icons/Line Hero Pack/Master/SVG/Music/Music_speaker_audio_sound.svg",
1111
"shortDescription": "Play audio with an expression as filename.",
12-
"version": "1.0.0",
12+
"version": "1.1.0",
1313
"description": [
1414
"Allows for playing a sound resource by filename as a string. This also allows for dynamically selecting a filename via string expressions, which can be useful for things like reducing the number of events required for playing voiced dialogue in larger games or dynamic music based on the current room.",
1515
"",
1616
"Please note, you may need to preload your audio files via events or resources panel because of how resources are now loaded gradually. "
1717
],
18+
"origin": {
19+
"identifier": "AudioByName",
20+
"name": "gdevelop-extension-store"
21+
},
1822
"tags": [
1923
"sound",
2024
"music"
2125
],
2226
"authorIds": [
2327
"Khhq7a4Lu8bt91GLLhG0QiGLpfx2",
24-
"8Ih1aa8f5gWUp4UB2BdhQ2iXWxJ3"
28+
"8Ih1aa8f5gWUp4UB2BdhQ2iXWxJ3",
29+
"dt0tRnf2kHWJnjkrpnzTzNj9Yc63"
2530
],
2631
"dependencies": [],
32+
"globalVariables": [],
33+
"sceneVariables": [],
2734
"eventsFunctions": [
2835
{
2936
"description": "Play a music file on a specific channel by name or string expression. \nThis can be useful to reduce the number of events needed to dynamically play different music files. e.g. Playing music based off a room ID variable for the current room the player is in.\n\nNote: Music files should be preloaded before using these actions, such at the start of the first scene, current scene, or in the resources panel for the entire game. This is to avoid any potential audio pause since the normal resource loading at the start of the game or scene won't load these files by default. For web games, music files must be preloaded to start at all.",
@@ -202,8 +209,140 @@
202209
}
203210
],
204211
"objectGroups": []
212+
},
213+
{
214+
"description": "Play a sound file by name or string expression. \nThis can be useful to reduce the number of events needed to dynamically play different sound files. e.g. Playing a voice over line based off the current dialogue node name.\n\nNote: Sound files should be preloaded before using these actions, such at the start of the first scene, current scene, or in the resources panel for the entire game. This is to avoid any potential audio pause since the normal resource loading at the start of the game or scene won't load these files by default.",
215+
"fullName": "Play sound by name",
216+
"functionType": "Action",
217+
"name": "PlaySoundByName",
218+
"sentence": "Play the sound _PARAM1_, loop: _PARAM2_, volume: _PARAM3_, pitch: _PARAM4_",
219+
"events": [
220+
{
221+
"type": "BuiltinCommonInstructions::JsCode",
222+
"inlineCode": [
223+
"const soundManager = runtimeScene.getGame().getSoundManager();",
224+
"soundManager.playSound(",
225+
" eventsFunctionContext.getArgument(\"Sound\"),",
226+
" eventsFunctionContext.getArgument(\"Loop\"),",
227+
" eventsFunctionContext.getArgument(\"Volume\"),",
228+
" eventsFunctionContext.getArgument(\"Pitch\"));",
229+
""
230+
],
231+
"parameterObjects": "",
232+
"useStrict": true,
233+
"eventsSheetExpanded": true
234+
}
235+
],
236+
"parameters": [
237+
{
238+
"description": "Audio file resource name",
239+
"longDescription": "The final string must match the full resource name as displayed in the resource list.",
240+
"name": "Sound",
241+
"type": "string"
242+
},
243+
{
244+
"defaultValue": "no",
245+
"description": "Repeat the sound",
246+
"name": "Loop",
247+
"optional": true,
248+
"type": "yesorno"
249+
},
250+
{
251+
"description": "Volume",
252+
"longDescription": "From 0-100, with 100 being full volume.",
253+
"name": "Volume",
254+
"type": "expression"
255+
},
256+
{
257+
"description": "Pitch (speed)",
258+
"longDescription": "1 for normal speed",
259+
"name": "Pitch",
260+
"type": "expression"
261+
}
262+
],
263+
"objectGroups": []
264+
},
265+
{
266+
"description": "Play a music file by name or string expression. \nThis can be useful to reduce the number of events needed to dynamically play different music files. e.g. Playing music based off a room ID variable for the current room the player is in.\n\nNote: Music files should be preloaded before using these actions, such at the start of the first scene, current scene, or in the resources panel for the entire game. This is to avoid any potential audio pause since the normal resource loading at the start of the game or scene won't load these files by default. For web games, music files must be preloaded to start at all.",
267+
"fullName": "Play music by name",
268+
"functionType": "Action",
269+
"name": "PlayMusicByName",
270+
"sentence": "Play the music _PARAM1_, loop: _PARAM2_, volume: _PARAM3_, pitch: _PARAM4_",
271+
"events": [
272+
{
273+
"type": "BuiltinCommonInstructions::JsCode",
274+
"inlineCode": [
275+
"const soundManager = runtimeScene.getGame().getSoundManager();",
276+
"soundManager.playMusic(",
277+
" eventsFunctionContext.getArgument(\"Music\"),",
278+
" eventsFunctionContext.getArgument(\"Loop\"),",
279+
" eventsFunctionContext.getArgument(\"Volume\"),",
280+
" eventsFunctionContext.getArgument(\"Pitch\"));",
281+
""
282+
],
283+
"parameterObjects": "",
284+
"useStrict": true,
285+
"eventsSheetExpanded": true
286+
}
287+
],
288+
"parameters": [
289+
{
290+
"description": "Audio file resource name",
291+
"longDescription": "The final string must match the full resource name as displayed in the resource list.",
292+
"name": "Music",
293+
"type": "string"
294+
},
295+
{
296+
"defaultValue": "no",
297+
"description": "Repeat the sound",
298+
"name": "Loop",
299+
"optional": true,
300+
"type": "yesorno"
301+
},
302+
{
303+
"description": "Volume",
304+
"longDescription": "From 0-100, with 100 being full volume.",
305+
"name": "Volume",
306+
"type": "expression"
307+
},
308+
{
309+
"description": "Pitch (speed)",
310+
"longDescription": "1 for normal speed",
311+
"name": "Pitch",
312+
"type": "expression"
313+
}
314+
],
315+
"objectGroups": []
205316
}
206317
],
318+
"eventsFunctionsFolderStructure": {
319+
"folderName": "__ROOT",
320+
"children": [
321+
{
322+
"functionName": "PlayMusicOnChannelByName"
323+
},
324+
{
325+
"functionName": "PlaySoundOnChannelByName"
326+
},
327+
{
328+
"functionName": "PlayMusicByName"
329+
},
330+
{
331+
"functionName": "PlaySoundByName"
332+
},
333+
{
334+
"folderName": "Loading",
335+
"children": [
336+
{
337+
"functionName": "PreloadSoundByName"
338+
},
339+
{
340+
"functionName": "PreloadMusicByName"
341+
}
342+
]
343+
}
344+
]
345+
},
207346
"eventsBasedBehaviors": [],
208347
"eventsBasedObjects": []
209-
}
348+
}

0 commit comments

Comments
 (0)