ГлавнаяСправка по использованию серверного ActionScriptКласс Application › application.clearStreams()

application.clearStreams()

application.clearStreams(streamPath)

Очищает записанные потоки, связанные с экземпляром приложения. Этом метод можно использовать как для удаления отдельного потока, так и всех потоков связанных с экземпляром приложения или же только тех потоков, которые находятся в определенной поддиректории экземпляра приложения или же потоков, имена которых совпадают с групповым образчиком.

Если метод application.clearStreams() вызывается для записываемого в данный момент потока, записанный файл, становится нулевой длинны (очищается), и все кэширование внутренние данные так же очищаются

При вызове application.clearStreams() срабатывает обработчик событий Stream.onStatus() с переданным в него информационном объекте содержащий информации об успешности либо же сбои вызова.

Примечание: Метод removeApp() Административного программного интерфейса приложения (Administration API ) можно как же использовать для удаления всех ресурсов отдельного приложений.

Доступно с версии сервера

Flash Communication Server 1

Параметры

streamPath
Строковое значение, означающее унифицированный идентификатор ресурса Uniform Resource Identifier (URI) потока.

Параметр streamPath указывает местонахождения потока относительно папки экземпляра приложения. Для разделения пути на директории используется (/) косая. Последний элемент пути может содержать групповой символ в качестве образчика (например, знак вопроса [?] и астериск [*]) или же имя самого потока.
Метод clearStreams() проходит через всю иерархию по указанному пути и очищает все записанные потоки, имя которых совпадает с образчиком группового символа. В случаи если указана косая, все потоки принадлежащие экземпляру приложения будут очищены.

Для того что бы очистить файлы FLV, F4V, или MP3, путь к потоку должен начинаются с flv:, mp4: или mp3:. Указывая flv: или mp3: расширение файла указывать не нужно, потому как .flv и .mp3 в этом случаи являются подразумеваемыми. Несмотря на это, при вызове application.clearStreams("mp4:foo") сервер удаляет все файлы с именем “foo” содержащиеся в контейнере MPEG-4; например foo.mp4, foo.mov, и foo.f4v. Для удаления определенного файла в запрос нужно добавить расширение файла; например application.clearStreams("mp4:foo.f4v").

Примечание: Если в начале пути файла не указано его расширение, удаляются только файлы FLV.

Следующие примеры демонстрируют некоторые возможные значения параметра streamPath:

  • flv:/ Очищает экземпляр приложения от всех принадлежащих ему FLV потоков.

  • mp3:/ Очищает экземпляр приложения от всех принадлежащих ему MP3 файлов.

  • mp4:/Очищает экземпляр приложения от всех принадлежащих ему F4V потоков (например, foo.mp4, foo.f4v, и так далее).

  • mp4:foo.mp4 Удаляет файл foo.mp4.

  • mp4:foo.mov Удаляет файл foo.mov.

  • mp3:/mozart/requiem Удаляет MP3 файл с именем requiem.mp3 из подпапки /mozart находящейся в папке экземпляра приложения.

  • mp3:/mozart/* Удаляет все MP3 файлы из подпапки /mozart находящейся в папке экземпляра приложения.

  • /report Очищает файл потока report.flv находящийся в папке экземпляра приложения.

  • /presentations/intro Очищает записанный поток intro.flv из подпапки /presentations находящейся в папке экземпляра приложения; если intro это имя директории, никаких потоков не удаляется.

  • /presentations/* Удаляет все FLV файлы из подпапки /presentations находящейся в папке экземпляра приложения. Подпапка /presentations так же будет удалена, если нету потоков в данном пространстве имён.

  • /presentations/report?? удаляет все FLV файлы имя которых начинается на “report” и продолжается любыми двумя символами. Если в перечне файлов каталога указаны директории, директории очищаются от всех потоков, имя которых совпадает с report??.

Возвращает

Булево значение равное true если поток, находящийся по указанному пути был удалён; в противном случаи false. Если групповой символ использовался для удаления нескольких файлов потоков, метод возвращает true лишь в том случаи, если все потоки, совпадающие с образчиком группового символа были успешно удалены; в противном случаи возвращается false.

Пример

Следующий пример кода удаляет все записанные потоки:

function onApplicationStop(){ 
    application.clearStreams("/"); 
}

Следующий пример удаляет все MP3 файлы из подпапки /disco находящейся внутри папки экземпляра приложения:

function onApplicationStop(){ 
    application.clearStreams("mp3:/disco/*"); 
}

Остальные методы и свойства

Ярлыки: , ,

  1. Пока без комментариев.
  1. Пока нету.