Skip to content

Latest commit

 

History

History
174 lines (129 loc) · 7.45 KB

api.md

File metadata and controls

174 lines (129 loc) · 7.45 KB

flv.js API

This document use TypeScript-like definitions to describe interfaces.

Interfaces

flv.js exports all the interfaces through flvjs object which exposed in global context window.

flvjs object can also be accessed by require or ES6 import.

Functions:

Classes:

Enums:

flvjs.createPlayer()

function createPlayer(mediaDataSource: MediaDataSource, config?: Config): Player;

Create a player instance according to type field indicated in mediaDataSource, with optional config.

MediaDataSource

Field Type Description
type string Indicates media type, 'flv' or 'mp4'
isLive? boolean Indicates whether the data source is a live stream
cors? boolean Indicates whether to enable CORS for http fetching
withCredentials? boolean Indicates whether to do http fetching with cookies
duration? number Indicates total media duration, in milliseconds
filesize? number Indicates total file size of media file, in bytes
url? string Indicates media URL, can be starts with 'https(s)' or 'ws(s)' (WebSocket)
segments? Array<MediaSegment> Optional field for multipart playback, see MediaSegment

If segments field exists, transmuxer will treat this MediaDataSource as a multipart source.

In multipart mode, duration filesize url field in MediaDataSource structure will be ignored.

MediaSegment

Field Type Description
duration number Required field, indicates segment duration in milliseconds
filesize? number Optional field, indicates segment file size in bytes
url string Required field, indicates segment file URL

Config

Field Type Default Description
enableWorker? boolean false Enable separated thread for transmuxing (unstable for now)
enableStashBuffer? boolean true Enable IO stash buffer. Set to false if you need realtime (minimal latency) for live stream playback, but may stalled if there's network jittering.
stashInitialSize? number 384KB Indicates IO stash buffer initial size. Default is 384KB. Indicate a suitable size can improve video load/seek time.
isLive? boolean false Same to isLive in MediaDataSource, ignored if has been set in MediaDataSource structure.
lazyLoad? boolean true Abort the http connection if there's enough data for playback.
lazyLoadMaxDuration? number 3 * 60 Indicates how many seconds of data to be kept for lazyLoad.
lazyLoadRecoverDuration? number 30 Indicates the lazyLoad recover time boundary in seconds.
deferLoadAfterSourceOpen? boolean true Do load after MediaSource sourceopen event triggered. On Chrome, tabs which be opened in background may not trigger sourceopen event until switched to that tab.
accurateSeek? boolean false Accurate seek to any frame, not limited to video IDR frame, but may a bit slower. Available on Chrome > 50, FireFox and Safari.
seekType? string 'range' 'range' use range request to seek, or 'param' add params into url to indicate request range.
seekParamStart? string 'bstart' Indicates seek start parameter name for seekType = 'param'
seekParamEnd? string 'bend' Indicates seek end parameter name for seekType = 'param'
rangeLoadZeroStart? boolean false Send Range: bytes=0- for first time load if use Range seek
customSeekHandler? object undefined Indicates a custom seek handler
reuseRedirectedURL? boolean false Reuse 301/302 redirected url for subsequence request like seek, reconnect, etc.

flvjs.isSupported()

function isSupported(): boolean;

Return true if basic playback can works on your browser.

flvjs.getFeatureList()

function getFeatureList(): FeatureList;

Return a FeatureList object which has following details:

FeatureList

Field Type Description
mseFlvPlayback boolean Same to flvjs.isSupported(), indicates whether basic playback works on your browser.
mseLiveFlvPlayback boolean Indicates whether HTTP FLV live stream can works on your browser.
networkStreamIO boolean Indicates whether the network loader is streaming.
networkLoaderName string Indicates the network loader type name.
nativeMP4H264Playback boolean Indicates whether your browser support H.264 MP4 video file natively.
nativeWebmVP8Playback boolean Indicates whether your browser support WebM VP8 video file natively.
nativeWebmVP9Playback boolean Indicates whether your browser support WebM VP9 video file natively.

flvjs.FlvPlayer

interface FlvPlayer extends Player {}

FLV player which implements the Player interface. Can be created by new operator directly.

flvjs.NativePlayer

interface NativePlayer extends Player {}

Player wrapper for browser's native player (HTMLVideoElement) without MediaSource src, which implements the Player interface. Useful for singlepart MP4 file playback.

interface Player (abstract)

interface Player {
    constructor(mediaDataSource: MediaDataSource, config?: Config): Player;
    destroy(): void;
    on(event: string, listener: Function): void;
    off(event: string, listener: Function): void;
    attachMediaElement(mediaElement: HTMLMediaElement): void;
    detachMediaElement(): void;
    load(): void;
    unload(): void;
    play(): void;
    pause(): void;
    type: string;
    buffered: TimeRanges;
    duration: number;
    volume: number;
    muted: boolean;
    currentTime: number;
    mediaInfo: Object;
    statisticsInfo: Object;
}

flvjs.LoggingControl

A global interface which include several static getter/setter to set flv.js logcat verbose level.

interface LoggingControl {
    forceGlobalTag: boolean,
    globalTag: string,
    enableAll: boolean,
    enableDebug: boolean,
    enableVerbose: boolean,
    enableInfo: boolean,
    enableWarn: boolean,
    enableError: boolean,
    getConfig: Object,
    applyConfig: Object,
}