На главную страницу
Форум

Статья :: LiveAudio и LiveConnect

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

Глава 16
LiveAudio и LiveConnect

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-плэйера.

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

Дата последнего обновления: 25 мая 1999 года.
Copyright (c) 1999 Netscape Communications Corporation

LiveAudio и LiveConnect
страницы в данном разделе
> Дополнительные Статьи	> Индекс
> Отображение Ошибок с Помощью Консоли JavaScript	> Клиентский JavaScript. Руководство.
> Клиентский JavaScript. Руководство.	> Ведрение JavaScript в HTML
> Обработка Событий	> Выражения и Операции
> Функции	> Словарь
> Значения, Переменные и Литералы	> Клиентский JavaScript. Руководство.
> JavaScript. Обзор.	> LiveConnect. Обзор.
> LiveAudio и LiveConnect	> Mail-Фильтры
> Использование Объектов Navigator'a	> Работа с Объектами
> Объектная Модель. Детали.	> Приложения
> Специфические Клиентские Возможности	> Возможности Ядра Языка
> Работа с LiveConnect	> об Этой Книге
> Регулярные Выражения	> Безопасность в JavaScript
> Операторы	> toc.htm
> whatsnew.htm	> windows.htm