Пакет | fl.rsl |
Класс | public class RSLPreloader |
Наследование | RSLPreloader EventDispatcher Object |
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flash CS5 |
Версии среды выполнения: | Flash Player 10.1, AIR 2 |
RSLEvent.RSL_LOAD_COMPLETE
, RSLErrorEvent.RSL_LOAD_FAILED
или RSLEvent.RSL_PROGRESS
) для обозначения состояния загрузки файлов RSL.
Связанные элементы API
Свойство | Определено | ||
---|---|---|---|
constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | ||
debugWaitTime : int
Это значение указывает число миллисекунд, которое должно пройти перед загрузкой первого файла RSL. | RSLPreloader | ||
numRSLInfos : int [только для чтения]
Число экземпляров RSLInfo, добавленных посредством addRSLInfo(). | RSLPreloader |
Метод | Определено | ||
---|---|---|---|
RSLPreloader(mainTimeline:MovieClip = null)
Конструктор. | RSLPreloader | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | ||
Добавляет описательную запись RSLInfo в загружаемый SWF- или SWZ-файл. | RSLPreloader | ||
Посылает событие в поток событий. | EventDispatcher | ||
Получает запись RSLInfo, добавленную с помощью метода addRSLInfo() в указанном индексе. | RSLPreloader | ||
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | ||
Показывает, определено ли заданное свойство для объекта. | Object | ||
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | ||
Метод loadContent вызывается из кадра 2 из содержащего SWF-файла, когда имя класса содержимого передается методу start(). | RSLPreloader | ||
Показывает наличие заданного свойства и его перечисляемость. | Object | ||
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | ||
Задает доступность динамического свойства для операций цикла. | Object | ||
Начинает загрузку файлов RSL. | RSLPreloader | ||
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | ||
Возвращает строковое представление заданного объекта. | Object | ||
Возвращает элементарное значение заданного объекта. | Object | ||
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher |
Событие | Сводка | Определено | ||
---|---|---|---|---|
[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным. | EventDispatcher | |||
[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным. | EventDispatcher | |||
Отправляется классом RSLPreloader после завершения загрузки всех RSL. | RSLPreloader | |||
Отправляется классом RSLPreloader после завершения загрузки всех RSL, если один или несколько файлов не были загружены. | RSLPreloader | |||
Отправляется классом RSLPreloader для обозначения хода загрузки файлов RSL. | RSLPreloader |
debugWaitTime | свойство |
debugWaitTime:int
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flash CS5 |
Версии среды выполнения: | Flash Player 10.1, AIR 2 |
Это значение указывает число миллисекунд, которое должно пройти перед загрузкой первого файла RSL. Это позволяет симулировать работу конечного пользователя и протестировать цикл предварительной загрузки. Это особенно полезно при тестировании подписанных кэшированных файлов RSL (SWZ-файлов), когда требуется встроить задержку загрузки без опустошения кэша SWZ-файлов. Перед развертыванием отключите любой код, который устанавливает значение больше 0. Для вызова кода используйте константу конфигурации отладки, например CONFIG::DEBUG
. Также можно задать относительно БОЛЬШУЮ задержку, например 5000 (то есть 5 секунд), как напоминание, что требуется удалить код отладки. Для экземпляров RSLLoader, которые автоматически создаются средой разработки, задержку можно задать путем определения метода setRSLPreloader (value:RSLPreloader):void
в загружающем SWF-файле анимации или в коде главной временной шкалы.
import fl.rsl.RSLPreloader; function setRSLPreloader(preloader:RSLPreloader):void { preloader.debugWaitTime = 10000; }
Значением по умолчанию является 0.
Реализация
public function get debugWaitTime():int
public function set debugWaitTime(value:int):void
numRSLInfos | свойство |
numRSLInfos:int
[только для чтения] Язык версии: | ActionScript 3.0 |
Версия продукта: | Flash CS5 |
Версии среды выполнения: | Flash Player 10.1, AIR 2 |
Число экземпляров RSLInfo, добавленных посредством addRSLInfo()
.
for(var i:int = 0; i < myPreloader.numRSLInfos; i++) { trace('rsl ' + i); var urls:Array = myPreloader.getRSLInfoAt(i).rslURLs; for(var j:int = 0; j < urls.length; j++) { trace(' url: ' + urls[j]); } }
Реализация
public function get numRSLInfos():int
Связанные элементы API
RSLPreloader | () | Конструктор |
public function RSLPreloader(mainTimeline:MovieClip = null)
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flash CS5 |
Версии среды выполнения: | Flash Player 10.1, AIR 2 |
Конструктор. Когда в процессе разработки автоматически выдает код для предварительной загрузки SWZ-файлов, в качестве аргумента передается класс основной временной шкалы. Обычно это неприменимо для кода, создаваемого конечным пользователем.
ПараметрыmainTimeline:MovieClip (default = null )
|
addRSLInfo | () | метод |
public function addRSLInfo(info:RSLInfo):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flash CS5 |
Версии среды выполнения: | Flash Player 10.1, AIR 2 |
Добавляет описательную запись RSLInfo в загружаемый SWF- или SWZ-файл.
import fl.rsl.RSLInfo; var info:RSLInfo = new RSLInfo(); info.addEntry('rsl.swf'); myPreloader.addRSLInfo(info); myPreloader.start();
Параметры
info:RSLInfo |
getRSLInfoAt | () | метод |
public function getRSLInfoAt(index:int):RSLInfo
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flash CS5 |
Версии среды выполнения: | Flash Player 10.1, AIR 2 |
Получает запись RSLInfo, добавленную с помощью метода addRSLInfo()
в указанном индексе. Индекс соответствует порядку, в котором добавлялись записи с помощью addRSLInfo()
.
for (var i:int = 0; i < myPreloader.numRSLInfos; i++) { trace('rsl ' + i); var urls:Array = myPreloader.getRSLInfoAt(i).rslURLs; for (var j:int = 0; j < urls.length; j++) { trace(' url: ' + urls[j]); } }
Параметры
index:int |
RSLInfo |
Связанные элементы API
loadContent | () | метод |
public function loadContent():void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flash CS5 |
Версии среды выполнения: | Flash Player 10.1, AIR 2 |
Метод loadContent вызывается из кадра 2 из содержащего SWF-файла, когда имя класса содержимого передается методу start(). Он обычно не используется для кодов, создаваемых конечным пользователем.
Связанные элементы API
start | () | метод |
public function start(preloaderAnimClass:Class = null, contentClassName:String = null):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flash CS5 |
Версии среды выполнения: | Flash Player 10.1, AIR 2 |
Начинает загрузку файлов RSL. Эту функцию следует вызвать только после того, как все записи RSLInfo добавлены с помощью метода addRSLInfo()
. При автоматическом выводе кода в процессе разработки можно использовать два дополнительных аргумента. Первый, подкласс ByteArray, предназначен для загрузки анимации предварительно загружаемого SWF-файла. Второй аргумент содержит имя подкласса ByteArray для содержимого SWF. Эти параметры обычно не используются для кодов, создаваемых пользователем.
Параметры
preloaderAnimClass:Class (default = null )
| |
contentClassName:String (default = null )
|
Связанные элементы API
rslLoadComplete | Событие |
fl.events.RSLEvent
свойство RSLEvent.type =
fl.events.RSLEvent.RSL_LOAD_COMPLETE
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flash CS5 |
Версии среды выполнения: | Flash Player 10.1, AIR 2 |
Отправляется классом RSLPreloader после завершения загрузки всех RSL.
Событие, отправляемое классомRSLPreloader
после успешного завершения загрузки всех RSL. Для данного типа событий свойства bytesLoaded
и bytesTotal
всегда имеют значение 0. При предварительной загрузке с пользовательским циклом событий содержимое пользователя ДОЛЖНО прослушивать это событие, чтобы определить, когда выйти из цикла анимации загрузки.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
bubbles | true |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Экземпляр DisplayObject, добавляемый в список отображения. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
rslsLoaded | Количество файлов, которые загрузились успешно. |
rslsFailed | Число файлов, которые не удалось загрузить. |
rslsTotal | Общее количество загруженных и незагруженных файлов. |
bytesLoaded | Общее количество загруженных байтов в файлах, которые были успешно загружены. |
bytesTotal | Общее количество загруженных байтов во всех файлах независимо от того, завершилась их загрузка успешно или нет. |
import fl.events.RSLEvent; myPreloader.addEventListener(RSLEvent.RSL_LOAD_COMPLETE, loadComplete); function loadComplete(e:RSLEvent) { gotoAndPlay('startOfContent'); }
rslLoadFailed | Событие |
fl.events.RSLErrorEvent
свойство RSLErrorEvent.type =
fl.events.RSLErrorEvent.RSL_LOAD_FAILED
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flash CS5 |
Версии среды выполнения: | Flash Player 10.1, AIR 2 |
Отправляется классом RSLPreloader после завершения загрузки всех RSL, если один или несколько файлов не были загружены.
Ошибка, отправляемая классомRSLPreloader
после завершения загрузки всех RSL, если один или несколько файлов не были загружены. При предварительной загрузке с пользовательским циклом событий содержимое пользователя ДОЛЖНО прослушивать это событие, чтобы определить, когда выйти из цикла анимации загрузки.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
bubbles | true |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Экземпляр DisplayObject, добавляемый в список отображения. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
rslsLoaded | Количество файлов, которые загрузились успешно. |
rslsFailed | Число файлов, которые не удалось загрузить. |
rslsTotal | Общее количество загруженных и незагруженных файлов. |
failedURLs | Массив файлов, которые не удалось загрузить. |
import fl.events.RSLErrorEvent; myPreloader.addEventListener(RSLErrorEvent.RSL_LOAD_FAILED, rslLoadFailedHandler); function rslLoadFailedHandler(e:RSLErrorEvent) { gotoAndPlay('rslLoadFailure'); }
rslProgress | Событие |
fl.events.RSLEvent
свойство RSLEvent.type =
fl.events.RSLEvent.RSL_PROGRESS
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flash CS5 |
Версии среды выполнения: | Flash Player 10.1, AIR 2 |
Отправляется классом RSLPreloader для обозначения хода загрузки файлов RSL.
Событие, отправляемое классомRSLPreloader
для обозначения хода загрузки файлов RSL. Это единственный тип события, для которого значения свойств bytesLoaded
и bytesTotal
не равны нулю.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
bubbles | true |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Экземпляр DisplayObject, добавляемый в список отображения. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget для обращения к объекту в списке отображения, обрабатывающему событие в данный момент. |
rslsLoaded | Количество файлов, которые загрузились успешно. |
rslsFailed | Число файлов, которые не удалось загрузить. |
rslsTotal | Общее количество загруженных и незагруженных файлов. |
bytesLoaded | Общее количество загруженных байтов в файлах, которые были успешно загружены. |
bytesTotal | Общее количество загруженных байтов во всех файлах независимо от того, завершилась их загрузка успешно или нет. |
import fl.events.RSLEvent; myPreloader.addEventListener(RSLEvent.RSL_PROGRESS, progressHandler); function progressHandler(e:RSLEvent) { trace('rslsLoaded = ' + e.rslsLoaded); trace('rslsFailed = ' + e.rslsFailed); trace('rslsTotal = ' + e.rslsTotal); trace('bytesLoaded = ' + e.bytesLoaded); trace('bytesTotal = ' + e.bytesTotal); }
Tue Jun 12 2018, 11:34 AM Z