Воспроизведение аудио
Функции для воспроизведения аудио из библиотеки CLEO 4, ставшие встроенными в MoonLoader в версии .026.
loadAudioStream
AudioStream handle = loadAudioStream(zstring audio)
Описание
Загружает аудио из файла или по веб-адресу
Аргументы
zstring audio
путь к файлу или Web-адрес
Возвращаемые значения
AudioStream handle
аудиопоток
loadAudioStreamFromMemory
AudioStream handle = loadAudioStreamFromMemory(uint address, uint size)
Описание
Загружает аудиопоток из файла в памяти процесса
Аргументы
uint address
адрес памяти
uint size
размер файла
Возвращаемые значения
AudioStream handle
загруженный аудиопоток
setAudioStreamState
setAudioStreamState(AudioStream handle, int state)
Описание
Задаёт новый статус аудиопотоку
Аргументы
AudioStream handle
аудиопоток
int state
состояние
Пример использования
local as_action = require('moonloader').audiostream_state setAudioStreamState(audio, as_action.PLAY)
releaseAudioStream
releaseAudioStream(AudioStream handle)
Описание
Освобождает загруженный аудиопоток. Использовать не необходимо, т.к. аудиопотоки освобождаются автоматически сборщиком мусора.
Аргументы
AudioStream handle
аудиопоток
Пример использования
releaseAudioStream(audiostream) -- правильно: audiostream = nil
getAudioStreamLength
double length = getAudioStreamLength(AudioStream handle)
Описание
Возвращает длительность аудиопотока в секундах
Аргументы
AudioStream handle
аудиопоток
Возвращаемые значения
double length
длительность
getAudioStreamState
int state = getAudioStreamState(AudioStream handle)
Описание
Возвращает статус аудиопотока
Аргументы
AudioStream handle
аудиопоток
Возвращаемые значения
int state
статус
Пример использования
local as_status = require('moonloader').audiostream_status if getAudioStreamState(as) == as_status.STOPPED then -- ... end
getAudioStreamVolume
float volume = getAudioStreamVolume(AudioStream audio)
Описание
Возвращает громкость аудиопотока
Аргументы
AudioStream audio
аудиопоток
Возвращаемые значения
float volume
громкость
setAudioStreamVolume
setAudioStreamVolume(AudioStream audio, float volume)
Описание
Устанавливает громкость аудиопотока
Аргументы
AudioStream audio
аудиопоток
float volume
громкость
setAudioStreamLooped
setAudioStreamLooped(AudioStream audio, bool loop)
Описание
Переключает статус зацикленности аудиопотока
Аргументы
AudioStream audio
аудиопоток
bool loop
зациклить
load3dAudioStream
AudioStream handle = load3dAudioStream(zstring audio)
Описание
Загружает аудиопоток с поддержкой объёмного (3D) звука
Аргументы
zstring audio
путь к файлу или веб-адрес
Возвращаемые значения
AudioStream handle
загруженный аудиопоток
load3dAudioStreamFromMemory
AudioStream handle = load3dAudioStreamFromMemory(uint address, uint size)
Описание
Загружает аудиопоток с объёмным звучанием из файла в памяти процесса
Аргументы
uint address
адрес памяти
uint size
размер
Возвращаемые значения
AudioStream handle
загруженный аудиопоток
setPlay3dAudioStreamAtCoordinates
setPlay3dAudioStreamAtCoordinates(AudioStream handle, float posX, float posY, float posZ)
Описание
Устанавливает 3D-аудиопотоку позицию в мире игры
Аргументы
AudioStream handle
аудиопоток
float posX, posY, posZ
координаты
Пример использования
local as_action = require('moonloader').audiostream_state local as = load3dAudioStream('moonloader/resource/audio/sound.mp3') local x, y, z = getCharCoordinates(PLAYER_PED) setPlay3dAudioStreamAtCoordinates(as, x, y, z) setAudioStreamState(audio, as_action.PLAY)
setPlay3dAudioStreamAtObject
setPlay3dAudioStreamAtObject(AudioStream audio, Object object)
Описание
Прикрепляет 3D-звук к объекту
Аргументы
AudioStream audio
аудиопоток
Object object
объект
setPlay3dAudioStreamAtChar
setPlay3dAudioStreamAtChar(AudioStream audio, Ped ped)
Описание
Прикрепляет 3D-звук к персонажу
Аргументы
AudioStream audio
аудиопоток
Ped ped
персонаж
setPlay3dAudioStreamAtCar
setPlay3dAudioStreamAtCar(AudioStream audio, Vehicle car)
Описание
Прикрепляет 3D-звук к транспортному средству
Аргументы
AudioStream audio
аудиопоток
Vehicle car
транспорт