flv.js README

The project's README from github.com/bilibili/flv.js. As one markdown file: README.md.

flv.js npm

An HTML5 Flash Video (FLV) Player written in pure JavaScript without Flash. LONG LIVE FLV!

This project relies on Media Source Extensions to work.

For FLV live stream playback, please consider mpegts.js which is under active development.

This project will become rarely maintained.

Overview

flv.js works by transmuxing FLV file stream into ISO BMFF (Fragmented MP4) segments, followed by feeding mp4 segments into an HTML5 <video> element through Media Source Extensions API.

Demo

http://bilibili.github.io/flv.js/demo/

Features

Installation

npm install --save flv.js

Build

npm ci                 # install dependencies / dev-dependences
npm run build:debug    # debug version flv.js will be emitted to /dist
npm run build          # minimized release version flv.min.js will be emitted to /dist

cnpm mirror is recommended if you are in Mainland China.

CORS

If you use standalone video server for FLV stream, Access-Control-Allow-Origin header must be configured correctly on video server for cross-origin resource fetching.

See cors.md for more details.

Getting Started

<script src="flv.min.js"></script>
<video id="videoElement"></video>
<script>
    if (flvjs.isSupported()) {
        var videoElement = document.getElementById('videoElement');
        var flvPlayer = flvjs.createPlayer({
            type: 'flv',
            url: 'http://example.com/flv/video.flv'
        });
        flvPlayer.attachMediaElement(videoElement);
        flvPlayer.load();
        flvPlayer.play();
    }
</script>

Limitations

Multipart playback

You only have to provide a playlist for MediaDataSource. See multipart.md

Livestream playback

See livestream.md

API and Configuration

See api.md

Debug

npm ci         # install dependencies / dev-dependences
npm run dev    # watch file changes and build debug version on the fly

Design

See design.md

License

Copyright (C) 2016 Bilibili. All Rights Reserved.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

flv.js (bilibili/flv.js)

Searching Database…

23.2K ·GitHub
Что это такое?flv.js — это HTML5-проигрыватель FLV (Flash Video), написанный на чистом JavaScript. Плагин Flash для него не нужен.
Это библиотека для браузера или отдельное приложение?Это JavaScript-библиотека, которую встраивают в веб-страницу. Она перепаковывает потоки FLV в сегменты Fragmented MP4 и передает их в HTML5-элемент video через Media Source Extensions.
Как добавить flv.js в свой проект?Соберите библиотеку готовыми npm/webpack-скриптами (например, 'npm run build' для производственной сборки), затем подключите получившийся скрипт и привяжите его к элементу video, как описано в разделе Getting Started документации.
Нужны ли flv.js Flash или какие-либо плагины?Нет. Он опирается только на встроенный в браузер API Media Source Extensions, а также на внутренние JS-зависимости, такие как es6-promise и webworkify-webpack.
Проект всё ещё активно поддерживается?Нет. В README сказано, что flv.js будут поддерживать редко, а для воспроизведения живых трансляций автор рекомендует вместо него использовать mpegts.js.
В каких браузерах он работает?Он совместим с Chrome, Firefox, Safari 10, IE11 и Edge, так как ему нужна только поддержка MSE, встроенная в браузер.
Какие видео- и аудиокодеки может воспроизводить flv.js?Он воспроизводит контейнеры FLV с видео H.264 и аудио AAC или MP3, а также поддерживает воспроизведение видео, разделенного на сегменты (multipart).
Может ли flv.js воспроизводить живые трансляции, а не только файлы?Да, он поддерживает живые трансляции с низкой задержкой по HTTP-FLV и живые трансляции FLV поверх WebSocket. При этом HTTP FLV для трансляций работает не во всех браузерах.
Есть ли известные особенности кодеков или браузеров?Аудио MP3 сейчас не работает в IE11 и Edge, а живая трансляция по HTTP FLV надежна не во всех браузерах.
Что лучше использовать сегодня: flv.js или mpegts.js?Для воспроизведения живых трансляций автор рекомендует mpegts.js, так как он активно развивается, а flv.js поддерживается редко.
Creator
bilibili
Size
1.6 MB
Stars
23.2K
Age
10y
Commits · 90 Days