Plugin:MirLua/Module/m sounds: Difference between revisions

From Miranda NG
Jump to navigation Jump to search
(Introduce/add reusable localized strings)
(add missing header (levels of headers shouldn't be skipped - html corectness))
Line 11: Line 11:


__TOC__
__TOC__
== Functions ==


=== AddSound ===
=== AddSound ===

Revision as of 15:41, 15 April 2018

Other languages:

Allows you to work with sounds.

Include module:: local sounds = require('m_sounds')

<translate> Note</translate>
Parameters written in bold italics are obligatory.


Functions

AddSound

Registers a sound.

Parameters
name
Type:: string
Unique name.
description
Type:: string
Description.
section
Type:: string
Section name in Miranda sound settings. By default plugin name (MirLua) is used.
path
Type:: string
Path to sound file.
Result
Type:: boolean
Returns true if sound was registered successfully, otherwise false.
Example
local hIcon = sounds.AddSound('soundUniqueName', 'My super icon')

PlaySound

Plays sound by its unique name.

Parameters
name
Type:: string
Unique name.
Result
Type:: boolean
Returns true if sound was played successfully, otherwise false.
Example
sounds.PlaySound('soundUniqueName')

PlayFile

Plays sound from file.

Parameters
path
Type:: string
Path to file.
Result
Type:: boolean
Returns true if sound was played successfully, otherwise false.
Example
sounds.PlayFile('c:\\lambada.wav')