ISBN 966-7343-29-5 К.305

УДК 531.0
ББК 22.311
  К.305

Клиентский JavaScript. Руководство по Использованию

Глава 16
LiveAudio и LiveConnect

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

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

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

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



 

 

Наши ссылки на веб-страницы, можно скопировать html-код ссылки


Книги по математике и физике, программы HTML, компьютерные технологии

Документация HTML, XML, JavaScript на русском языке для разработчиков W3C

   Примечание. Удобная текстовая ссылка для форумов, блогов, цитирования материалов веб-сайта, код html можно скопировать и просто вставить в Ваши веб-страницы при цитировании материалов нашего веб-сайта. Материал носит неофициальный характер и приведен для ознакомления.