В данном документе содержится справочная информация о проигрывателе YouTube Chromeless Player.

Содержание

Обзор

Проигрыватель YouTube Chromeless Player дает разработчикам возможность настраивать проигрыватель YouTube с помощью собственных элементов управления, оболочки и даже таких функций как пользовательские плейлисты и меню.

Требования

У конечного пользователя должен быть установлен проигрыватель Flash 8 или более новой версии. Поэтому рекомендуется использовать SWFObject, чтобы встроить SWF и определить, какая версия проигрывателя Flash установлена у пользователя.

С чего начать

Прежде всего вам потребуется ключ разработчика. Чтобы его получить, нужно зарегистрироваться на странице регистрации.

Проигрыватель YouTube Chromeless Player состоит из двух файлов SWF. Файл apiplayer.SWF отвечает непосредственно за воспроизведение видео. Файл cl.SWF загружает apiplayer.SWF и предоставляет доступ к функциям API проигрывателя. Этот файл также содержит ограничения для обеспечения безопасности тестовой среды файла apiplayer.SWF, поэтому загрузка файлов SWF не дает прямого доступа к элементам проигрывателя.

Управлять проигрывателем можно двумя способами: загрузив этот файл SWF в другой файл SWF (или на веб-сайт с Flash-содержанием и т.п.) или встроив его непосредственно в страницу HTML и используя для управления проигрывателем JavaScript. Элементы управления JavaScript идентичны API JavaScript встроенного проигрывателя.

URL для загрузки файла SWF проигрывателя YouTube Chromeless Player:

http://gdata.youtube.com/apiplayer?key=DEV_KEY

Функции

Кроме перечисленных в документации по API JavaScript, можно использовать следующие операции.

loadVideoById(videoId:String, startSeconds:Number):Void

Загрузка выбранного видео и его воспроизведение. Если указано значение startSeconds (число может быть с плавающей точкой), воспроизведение видео начнется с кадра, наиболее близкого к указанному времени.

cueVideoById(videoId:String, startSeconds:Number):Void

Загрузка эскиза выбранного видео и подготовка проигрывателя к воспроизведению видео. Проигрыватель не выполняет запрос файла FLV, пока не вызвана функция playVideo() или . seekTo() Параметр startSeconds принимает значения с плавающей точкой или целые числа и указывает время, с которого следует начать воспроизведение видео при вызове функции playVideo(). Если указать значение для параметра startSeconds и вызвать функцию seekTo(), то параметр startSeconds игнорируется, а проигрыватель начинает воспроизведение с момента времени, указанного при вызове функции . seekTo() Когда все готово к воспроизведению видео с нужного момента, проигрыватель начинает воспроизведение выбранного отрезка видео (5).

setSize(width:Number, height:Number):Void

Установка размера проигрывателя YouTube Chromeless Player. Этот метод следует использовать вместо непосредственного указания ширины и высоты MovieClip. Обратите внимание, что этот метод не позволяет определить пропорции проигрывателя, поэтому следует сохранять соотношение 4:3. Если проигрыватель встроен непосредственно в страницу HTML, его размер автоматически обновляется в соответствии со значениями Stage.width и Stage.height, так что в этом случае вызывать функцию setSize() не нужно. По умолчанию размер файла SWF, загруженного в другой файл SWF, составляет 320 на 240 пикселей.

Примеры

Использование API JavaScript

При встраивании проигрывателя YouTube Chromeless Player в страницу HTML подключите API JavaScript, добавив к URL файла SWF переменную:

http://gdata.youtube.com/apiplayer?key=dev_key&enablejsapi=1

Список доступных методов API и примеров использования API JavaScript можно найти в справочной документации.

Пример использования API JavaScript в проигрывателе YouTube Chromeless Player можно найти здесь.

Загрузка проигрывателя в другой файл SWF

Для получения сведений о загрузке проигрывателя YouTube Chromeless Player в другой файл SWF обратитесь к документации по ActionScript 2.0. В данном случае используются те же самые вызовы API, кроме того к ним добавляются функции, описанные выше.

Наверх