AMP :: JavaScript :: Клиентский JavaScript, руководство по использованию

LiveAudio работает с LiveConnect. Используя LiveConnect, LiveAudio и JavaScript, событие, которое может быть описано программно с использованием среды JavaScript, может включать звуковое событие. Например, Вы можете создать альтернативный интерфейс управления звуком, задержать загрузку sound-файла, пока пользователь не щелкнул кнопку, создать кнопку, производящую шум при щелчке по ней, или создать звуковое подтверждения для действий интерфейса (заставить объект "проговаривать" свои действия при щелчке мыши или перемещении над ним курсора). В этой главе описано, как использовать JavaScript для управления встроенными LiveAudio-элементами.

В главе имеются следующие разделы:

JavaScript-методы для управления LiveAudio

Использование LiveAudio LiveConnect-методов

JavaScript-методы для управления LiveAudio

LiveAudio предоставляет следующие JavaScript-методы управления. Чтобы эти методы были доступны для JavaScript (и на web-странице), Вы обязаны внедрить LiveAudio-консоль (все, что эта консоль будет выполнять, она может даже быть скрыта) где-нибудь на странице.

play({loop[trUE, FALSE or an INT]}, '{url_to_sound}')

pause()

stop()

StopAll()

start_time({number of seconds})

end_time({number of seconds})

setvol({percentage number - without "%" sign})

fade_to({volume percent to fade to, without the "%"})

fade_from_to({volume % start fade}, {volume % end fade})

start_at_beginning()

stop_at_end()

Следующие JavaScript-методы индикации состояния не управляют LiveAudio plug-in'ом, но предоставляют информацию о текущем состоянии plug-in'а:

IsReady

IsPlaying

IsPaused

GetVolume

Использование LiveAudio LiveConnect-методов

В качестве пример использования JavaScript для управления LiveAudio plug-in'ом можно заставить JavaScript воспроизводить звук. В следующем примере дан весь HTML, необходимый для этого.

<HTML>
<BODY>

<EMBED SRC="sound1.wav"
HIDDEN=trUE>

<A HREF="javascript:document.embeds[0].play(false)">
Play the sound now!</A>

</BODY>
</HTML>

Вышеприведенный метод воспроизведения звукового файла, возможно, простейший, но может создать много проблем. Например, если Вы используете массив document.embeds, JavaScript 1.0 будет генерировать ошибку, поскольку массив embeds является элементом из JavaScript 1.1. Вместо использования массива embeds Вы можете идентифицировать тэг <EMBED>, который Вы хотите использовать в JavaScript, через использование атрибутов NAME и MASTERSOUND в оригинальном тэге <EMBED>:

<HTML>
<BODY>

<EMBED SRC="sound1.wav"
HIDDEN=trUE
NAME="firstsound"
MASTERSOUND>

<A HREF="javascript:document.firstsound.play(false)">
Play the sound now!</A>

</BODY>
</HTML>

Это значительно более внятный способ описания Вашего plug-in'а в JavaScript, который может значительно уменьшить путаницу. Если, например, у Вас имеются несколько звуков, внедренных в HTML-документ, разработчику может быть легче использовать атрибут NAME, чем массив embeds. В предыдущем примере можно видеть, что используется атрибут MASTERSOUND в тэге <EMBED>. Это сделано, потому что в любой момент, когда атрибут NAME используется для обращения к LiveAudio, соответствующий тэг с атрибутом MASTERSOUND также обязан быть предоставлен.

Другой известный пример использования LiveConnect и LiveAudio - задержка загрузки звука до тех пор, пока пользователь не щелкнет кнопку "play". Это делается так:

<HTML>
<HEAD>
<SCRIPT LANGUAGE="JavaScript">
<!-- Скрываем JavaScript от старых браузеров

function playDeferredSound() {
document.firstsound.play(false,
   'http://url_to_new_sound_file/sound1.wav');
}

// -->
</SCRIPT>

</HEAD>
<BODY>

<EMBED
SRC="stub1.wav"
HIDDEN=trUE
NAME="firstsound"
MASTERSOUND>

<A HREF="javascript:playDeferredSound()">Load and play the sound</A>

</BODY>
</HTML>

Файл-заглушка stub1.wav загружается сравнительно быстро. (Описание создания stub-файла см. на EmeraldNet LiveAudio http://emerald.net/liveaudio/.) Метод play загружает sound-файл только при его (метода) вызове. В этом примере sound-файл загружается только в том случае, если пользователь хочет его прослушать.

Web-дизайнерам может понадобиться создать совершенно новый интерфейс с помощью LiveConnect LiveAudio.
Для создания альтернативной консоли для проигрывания звуков дизайнер может сделать следующее:

<HTML>
<HEAD>

<SCRIPT LANGUAGE="JavaScript">
<!-- Прячем JavaScript от старых браузеров

function playSound() {
document.firstSound.play(false);
}

function pauseSound() {
document.firstSound.pause();
}

function stopSound() {
document.firstSound.stop();
}

function volup() {
currentVolume = document.firstSound.GetVolume();
newVolume = (currentVolume + 10);

if (document.firstSound.GetVolume() == 100) {
   alert("Volume is already at maximum");
}

if (newVolume < 90) {
   document.firstSound.setvol(newVolume);
}
else
{
   if ((newVolume <= 100) && (newVolume > 90)) {
      document.firstSound.setvol(100);
   }
}
}

function voldown() {
currentVolume = document.firstSound.GetVolume();
newVolume = (currentVolume - 10);

if (document.firstSound.GetVolume() == 0) {
   alert("Volume is already at minimum");
}

if (newVolume > 10) {
   document.firstSound.setvol(newVolume);
}
else {
   if ((newVolume >= 0) && (newVolume < 10)) {
      document.firstSound.setvol(0);
   }
}
}

// -->
</SCRIPT>
</HEAD>

<BODY>

<EMBED 
SRC="sound1.wav"
HIDDEN=trUE
AUTOSTART=FALSE
NAME="firstSound"
MASTERSOUND>

<P><A HREF="javascript:playSound()">Play the sound now!</A></P>
<P><A HREF="javascript:pauseSound()">Pause the sound now!</A></P>
<P><A HREF="javascript:stopSound()">Stop the sound now!</A></P>
<P><A HREF="javascript:volup()">Increment the Volume!</A></P>
<P><A HREF="javascript:voldown()">Decrement the Volume!</A></P>

</BODY>
</HTML>

Здесь проиллюстрировано, как Вы можете создать Ваш собственный метод управления sound-файлом. Возможности здесь поистине безграничны; Вы можете использовать изображения и обработчики onClick для симуляции Вашего собственного sound-плэйера.

Оглавление | Назад | Вперед | Индекс

AMP версия сайта
Мобильная версия

Сайт для компьютера
http://www.mat.net.ua