SoundAPI

SoundAPI - библиотека, упрощающая работу со звуком.

Загрузка[править]

Версия Ссылка Список изменений
1 Скачать
  • Первая версия
2 Скачать
  • Добавлен класс MultiSound
  • Добавлены методы setInEntity и setVolume для класса Sound
2.1 Скачать
  • Добавлен метод destroy
  • Добавлены методы isPlaying и isLooping для класса Sound 
  • Исправлена ошибка при создании пустого плеера
  • Исправлена формула зависимости громкости звука от расстояния
2.2 Скачать
  • Исправлена ошибка из-за которой звук не менял свою громкость вне зависимости к чему он привязан. 
  • Возвращена предыдущая формула громкости из-за неправильной работы предыдущей.
2.3 Скачать
  • Исправлена ошибка вызванная глобальностью библиотеки.
  • Громкость плеера зависит от громкости в настройках игры.

Условия использования[править]

  • Запрещено распространение на сторонних источниках без указания ссылки на официальное сообщество
  • Запрещено изменение кода библиотеки
  • Запрещено явное копирование кода в другие библиотеки или моды 

Используя данный продукт вы автоматически соглашаетесь с этими правилами

Документация[править]

Импорт библиотеки

IMPORT("SoundAPI")

Sound[править]

Для создания новго плеера необходимо использовать конструктор Sound()

var mySound = new Sound();

Затем зададим ему файл, который нужно воспроизводить

mySound.setSource("mySound.ogg");

Аргументом является наименование звукого файла из папки sounds/

Это можно сократить в одну строчку

var mySound = new Sound("mySound.ogg");

Для того, что бы запустить звук, нужно вызвать метод play()

mySound.play();

Для отсановки - stop()

mySound.stop();

Пример:[править]

IMPORT("SoundAPI")
var mySound = new Sound();
mySound.setSource("mySound.ogg");
//var mySound = new Sound("mySound.ogg");

Callback.addCallback("LevelLoaded", function () {
    mySound.play();
});

Все методы класса:[править]

Версия API Метод Аргументы Описание метода
2.1 destroy() - Уничтожить экземпляр Sound
2.1 isPlaying() - Играет ли плеер
2.1 isLooping() - Включен ли повтор у плеера
2 setInEntity(Entity entity, int radius)

entity - Сущность
radius - радиус слышимости звука (Больше 2)

Установить сущность источником звука 
1 setInBlock(int x,int y,int z,int radius)

x, y, z - координаты
radius - радиус слышимости звука (Больше 2)

Устанавливает источник звука по координатам
1 setInPlayer() Устанавливает источник звука "в игроке"
Можно использовать для звуков в меню.
1 setOnCompletion(function event) event - Событие происходящее при окончании воспроизведения Устанавливает действие при завершении воспроизведения. Не срабатывает при вызове stop()
1 setSource(string fileName) fileName - Название файла Установить файл для воспроизведения из директории мода
1

setLooping(bool looping)

looping - Повторное воспроизведение Повторное воспроизведение
2

setVolume(float volume)

volume - Уровень громкости(От 0 до 1) Установить громкость звука
1

play()

- Воспроизвести
1 pause() - Приостановить воспроизведение
1

reset()

- Сбросить плеер
1

stop()

- Остановить

MultiSound[править]

Класс MultiSound подходит для работы с несколькими звуками, зависимых друг от друга.

Для создания такого плеера нужен конструктор MultiSound()

var mySounds = new MultiSound([{
    src:"mySound.ogg"
},
{
    src:"mySound2.ogg",
    volume:0.5
}]);

Конструктор принимает один параметр - массив с объектами настроек для каждого звука

  • src - название звукового файла
  • volume - громкомсть звука

Для того, что бы запустить плеер, нужно вызвать метод play()

mySounds.play();

Для отсановки - stop()

mySounds.stop();

Класс имеет поле components -  массив звуков в виде классов Sound 

Пример[править]

IMPORT("SoundAPI");

var mySounds = new MultiSound([{
    src:"mySound.ogg"
},
{
    src:"mySound2.ogg",
    volume:.5
}]);
mySounds.components[0].setVolume(.9);

Callback.addCallback("LevelLoaded", function () {
    mySounds.play();
});

Все методы класса[править]

Версия API Метод Аргументы Описание метода
2.1 destroy() - ить экземпляр Sound
2 setInEntity(Entity entity, int radius) entity - Сущность
radius - радиус слышимости звука (Больше 2)
Установить сущность источником звука 
2 setInBlock(int x,int y,int z,int radius) x, y, z - координаты
radius - радиус слышимости звука (Больше 2)
Устанавливает источник звука по координатам
2 setInPlayer() - Устанавливает источник звука "в игроке"
Можно использовать для звуков в меню.
2 setLooping(bool looping) looping - Повторное воспроизведение Повторное воспроизведение
2 addVolume(float volume) volume - Уровень громкости Изменение громкомти плеера
2 play() - Воспроизвести
2 pause() - Приостановить воспроизведение
2 reset() - Сбросить плеер
2 stop() - Остановить