Audio.Load

Audio.Load (

number Channel,
string Filename,
boolean PlayAutomatic = false,
boolean Loop = false )

Описание

Загружает аудио файл в аудио канал.

Параметры

Channel

(число) Аудио канал для загрузки файла:

КОНСТАНТА CONSTANT	ЗНАЧЕНИЕ VALUE	ОПИСАНИЕ DESCRIPTION
CHANNEL_BACKGROUND	5	Фоновый аудио канал.
CHANNEL_EFFECTS	0	Канал эффектов (используется для звуков мышки - наезд на объект, сход с объекта и клик).
CHANNEL_NARRATION	6	Канал звукового сопровождения (дикторский) (используется для наложения голоса).
CHANNEL_USER1	1	1 пользовательский канал.
CHANNEL_USER2	2	2 пользовательский канал.
CHANNEL_USER3	3	3 пользовательский канал.
CHANNEL_USER4	4	4 пользовательский канал.

Filename

(строка) Путь к аудио файлу. Кликните по кнопке обзор (browse) для выбора файла. Также можно загружать потоковый аудио файл с веб адреса, например, http://www.indigorose.com/songs/myfile.ogg

Примечание: В AutoPlay Media Studio поддерживаются следующие форматы : .wav, .raw, .ogg.

PlayAutomatic

(логический) Запускать ли автоматически воспроизведение аудио файла после его загрузки:

ЗНАЧЕНИЕ VALUE	ОПИСАНИЕ DESCRIPTION
true	Автоматически запускать воспроизведение файла.
false	Не воспроизводить файл, пока не скажут это делать. (По умолчанию)

Loop

(логический) Заключать ли аудио файл в цикл по его окончании:

ЗНАЧЕНИЕ VALUE	ОПИСАНИЕ DESCRIPTION
true	Цикл.
false	Нет цикла. (По умолчанию)

Возврат

Ничего. Можно использовать Application.GetLastError для определения случился ли отказ в работе этого действия и почему.

Смотрите также: Связанные действия

Примеры

Пример 1

Audio.Load(CHANNEL_BACKGROUND, "AutoPlay\\Audio\\Soothing Music 3.wav", true, true);

Загружаем песню "Soothing Music 3.wav" в фоновый аудио канал, автоматически запускаем воспроизведение и указываем сделать цикл, т.е. запускаем файл опять сначала по окончании песни.

Пример 2

Audio.Load(CHANNEL_USER1, "AutoPlay\\Audio\\voiceover_012.ogg");

Загружаем Ogg Vorbis аудио файл по имени "voiceover_012.ogg" в первый пользовательский канал.

Пример 3

Audio.Load(CHANNEL_NARRATION, "http://www.indigorose.com/songs/myfile.ogg", true, true);
nError = Application.GetLastError();
if (nError~=0) then
    Dialog.Message("Error", _tblErrorMessages[nError]);
end

Загружаем Ogg Vorbis аудио файл по имени "myfile.ogg" с веб адреса для потокового аудио в канал звукового сопровождения. Вторая строка кода использует действие Application.GetLastError для просмотра, не произошло ли с действием Audio.Load неудачи. Если это случилось (код ошибки не равен 0), показываем диалоговое окно с сообщением об ошибке с этим конкретным кодом ошибки.

Смотрите также: Связанные действия