mk1990
3 years ago
committed by
GitHub
6 changed files with 688 additions and 21 deletions
File diff suppressed because one or more lines are too long
Binary file not shown.
@ -0,0 +1,637 @@ |
|||
declare namespace Jessibuca { |
|||
|
|||
/** 超时信息 */ |
|||
enum TIMEOUT { |
|||
/** 当play()的时候,如果没有数据返回 */ |
|||
loadingTimeout = 'loadingTimeout', |
|||
/** 当播放过程中,如果超过timeout之后没有数据渲染 */ |
|||
delayTimeout = 'delayTimeout', |
|||
} |
|||
|
|||
/** 错误信息 */ |
|||
enum ERROR { |
|||
/** 播放错误,url 为空的时候,调用 play 方法 */ |
|||
playError = 'playError', |
|||
/** http 请求失败 */ |
|||
fetchError = 'fetchError', |
|||
/** websocket 请求失败 */ |
|||
websocketError = 'websocketError', |
|||
/** webcodecs 解码 h265 失败 */ |
|||
webcodecsH265NotSupport = 'webcodecsH265NotSupport', |
|||
/** mediaSource 解码 h265 失败 */ |
|||
mediaSourceH265NotSupport = 'mediaSourceH265NotSupport', |
|||
/** wasm 解码失败 */ |
|||
wasmDecodeError = 'wasmDecodeError', |
|||
} |
|||
|
|||
interface Config { |
|||
/** |
|||
* 播放器容器 |
|||
* * 若为 string ,则底层调用的是 document.getElementById('id') |
|||
* */ |
|||
container: HTMLElement | string; |
|||
/** |
|||
* 设置最大缓冲时长,单位秒,播放器会自动消除延迟 |
|||
*/ |
|||
videoBuffer?: number; |
|||
/** |
|||
* worker地址 |
|||
* * 默认引用的是根目录下面的decoder.js文件 ,decoder.js 与 decoder.wasm文件必须是放在同一个目录下面。 */ |
|||
decoder?: string; |
|||
/** |
|||
* 是否不使用离屏模式(提升渲染能力) |
|||
*/ |
|||
forceNoOffscreen?: boolean; |
|||
/** |
|||
* 是否开启当页面的'visibilityState'变为'hidden'的时候,自动暂停播放。 |
|||
*/ |
|||
hiddenAutoPause?: boolean; |
|||
/** |
|||
* 是否有音频,如果设置`false`,则不对音频数据解码,提升性能。 |
|||
*/ |
|||
hasAudio?: boolean; |
|||
/** |
|||
* 设置旋转角度,只支持,0(默认),180,270 三个值 |
|||
*/ |
|||
rotate?: boolean; |
|||
/** |
|||
* 1. 当为`true`的时候:视频画面做等比缩放后,高或宽对齐canvas区域,画面不被拉伸,但有黑边。 等同于 `setScaleMode(1)` |
|||
* 2. 当为`false`的时候:视频画面完全填充canvas区域,画面会被拉伸。等同于 `setScaleMode(0)` |
|||
*/ |
|||
isResize?: boolean; |
|||
/** |
|||
* 1. 当为`true`的时候:视频画面做等比缩放后,完全填充canvas区域,画面不被拉伸,没有黑边,但画面显示不全。等同于 `setScaleMode(2)` |
|||
*/ |
|||
isFullSize?: boolean; |
|||
/** |
|||
* 1. 当为`true`的时候:ws协议不检验是否以.flv为依据,进行协议解析。 |
|||
*/ |
|||
isFlv?: boolean; |
|||
/** |
|||
* 是否开启控制台调试打 |
|||
*/ |
|||
debug?: boolean; |
|||
/** |
|||
* 1. 设置超时时长, 单位秒 |
|||
* 2. 在连接成功之前(loading)和播放中途(heart),如果超过设定时长无数据返回,则回调timeout事件 |
|||
*/ |
|||
timeout?: number; |
|||
/** |
|||
* 1. 设置超时时长, 单位秒 |
|||
* 2. 在连接成功之前,如果超过设定时长无数据返回,则回调timeout事件 |
|||
*/ |
|||
heartTimeout?: number; |
|||
/** |
|||
* 1. 设置超时时长, 单位秒 |
|||
* 2. 在连接成功之前,如果超过设定时长无数据返回,则回调timeout事件 |
|||
*/ |
|||
loadingTimeout?: number; |
|||
/** |
|||
* 是否支持屏幕的双击事件,触发全屏,取消全屏事件 |
|||
*/ |
|||
supportDblclickFullscreen?: boolean; |
|||
/** |
|||
* 是否显示网 |
|||
*/ |
|||
showBandwidth?: boolean; |
|||
/** |
|||
* 配置操作按钮 |
|||
*/ |
|||
operateBtns?: { |
|||
/** 是否显示全屏按钮 */ |
|||
fullscreen?: boolean; |
|||
/** 是否显示截图按钮 */ |
|||
screenshot?: boolean; |
|||
/** 是否显示播放暂停按钮 */ |
|||
play?: boolean; |
|||
/** 是否显示声音按钮 */ |
|||
audio?: boolean; |
|||
/** 是否显示录制按 */ |
|||
record?: boolean; |
|||
}; |
|||
/** |
|||
* 开启屏幕常亮,在手机浏览器上, canvas标签渲染视频并不会像video标签那样保持屏幕常亮 |
|||
*/ |
|||
keepScreenOn?: boolean; |
|||
/** |
|||
* 是否开启声音,默认是关闭声音播放的 |
|||
*/ |
|||
isNotMute?: boolean; |
|||
/** |
|||
* 加载过程中文案 |
|||
*/ |
|||
loadingText?: boolean; |
|||
/** |
|||
* 背景图片 |
|||
*/ |
|||
background?: string; |
|||
/** |
|||
* 是否开启MediaSource硬解码 |
|||
* * 视频编码只支持H.264视频(Safari on iOS不支持) |
|||
* * 不支持 forceNoOffscreen 为 false (开启离屏渲染) |
|||
*/ |
|||
useMSE?: boolean; |
|||
/** |
|||
* 是否开启Webcodecs硬解码 |
|||
* * 视频编码只支持H.264视频 (需在chrome 94版本以上,需要https或者localhost环境) |
|||
* * 支持 forceNoOffscreen 为 false (开启离屏渲染) |
|||
* */ |
|||
useWCS?: boolean; |
|||
/** |
|||
* 是否开启键盘快捷键 |
|||
* 目前支持的键盘快捷键有:esc -> 退出全屏;arrowUp -> 声音增加;arrowDown -> 声音减少; |
|||
*/ |
|||
hotKey?: boolean; |
|||
/** |
|||
* 在使用MSE或者Webcodecs 播放H265的时候,是否自动降级到wasm模式。 |
|||
* 设置为false 则直接关闭播放,抛出Error 异常,设置为true 则会自动切换成wasm模式播放。 |
|||
*/ |
|||
autoWasm?: boolean; |
|||
/** |
|||
* heartTimeout 心跳超时之后自动再播放,不再抛出异常,而直接重新播放视频地址。 |
|||
*/ |
|||
heartTimeoutReplay?: boolean, |
|||
/** |
|||
* heartTimeoutReplay 从试次数,超过之后,不再自动播放 |
|||
*/ |
|||
heartTimeoutReplayTimes?: number, |
|||
/** |
|||
* loadingTimeout loading之后自动再播放,不再抛出异常,而直接重新播放视频地址。 |
|||
*/ |
|||
loadingTimeoutReplay?: boolean, |
|||
/** |
|||
* heartTimeoutReplay 从试次数,超过之后,不再自动播放 |
|||
*/ |
|||
loadingTimeoutReplayTimes?: number |
|||
/** |
|||
* wasm解码报错之后,不再抛出异常,而是直接重新播放视频地址。 |
|||
*/ |
|||
wasmDecodeErrorReplay?: boolean, |
|||
/** |
|||
* https://github.com/langhuihui/jessibuca/issues/152 解决方案
|
|||
* 例如:WebGL图像预处理默认每次取4字节的数据,但是540x960分辨率下的U、V分量宽度是540/2=270不能被4整除,导致绿屏。 |
|||
*/ |
|||
openWebglAlignment?: boolean |
|||
} |
|||
} |
|||
|
|||
|
|||
declare class Jessibuca { |
|||
|
|||
constructor(config?: Jessibuca.Config); |
|||
|
|||
/** |
|||
* 是否开启控制台调试打印 |
|||
@example |
|||
// 开启
|
|||
jessibuca.setDebug(true) |
|||
// 关闭
|
|||
jessibuca.setDebug(false) |
|||
*/ |
|||
setDebug(flag: boolean): void; |
|||
|
|||
/** |
|||
* 静音 |
|||
@example |
|||
jessibuca.mute() |
|||
*/ |
|||
mute(): void; |
|||
|
|||
/** |
|||
* 取消静音 |
|||
@example |
|||
jessibuca.cancelMute() |
|||
*/ |
|||
cancelMute(): void; |
|||
|
|||
/** |
|||
* 留给上层用户操作来触发音频恢复的方法。 |
|||
* |
|||
* iPhone,chrome等要求自动播放时,音频必须静音,需要由一个真实的用户交互操作来恢复,不能使用代码。 |
|||
* |
|||
* https://developers.google.com/web/updates/2017/09/autoplay-policy-changes
|
|||
*/ |
|||
audioResume(): void; |
|||
|
|||
/** |
|||
* |
|||
* 设置超时时长, 单位秒 |
|||
* 在连接成功之前和播放中途,如果超过设定时长无数据返回,则回调timeout事件 |
|||
|
|||
@example |
|||
jessibuca.setTimeout(10) |
|||
|
|||
jessibuca.on('timeout',function(){ |
|||
//
|
|||
}); |
|||
*/ |
|||
setTimeout(): void; |
|||
|
|||
/** |
|||
* @param mode |
|||
* 0 视频画面完全填充canvas区域,画面会被拉伸 等同于参数 `isResize` 为false |
|||
* |
|||
* 1 视频画面做等比缩放后,高或宽对齐canvas区域,画面不被拉伸,但有黑边 等同于参数 `isResize` 为true |
|||
* |
|||
* 2 视频画面做等比缩放后,完全填充canvas区域,画面不被拉伸,没有黑边,但画面显示不全 等同于参数 `isFullResize` 为true |
|||
@example |
|||
jessibuca.setScaleMode(0) |
|||
|
|||
jessibuca.setScaleMode(1) |
|||
|
|||
jessibuca.setScaleMode(2) |
|||
*/ |
|||
setScaleMode(mode: number): void; |
|||
|
|||
/** |
|||
* 暂停播放 |
|||
* |
|||
* 可以在pause 之后,再调用 `play()`方法就继续播放之前的流。 |
|||
@example |
|||
jessibuca.pause().then(()=>{ |
|||
console.log('pause success') |
|||
|
|||
jessibuca.play().then(()=>{ |
|||
|
|||
}).catch((e)=>{ |
|||
|
|||
}) |
|||
|
|||
}).catch((e)=>{ |
|||
console.log('pause error',e); |
|||
}) |
|||
*/ |
|||
pause(): Promise<void>; |
|||
|
|||
/** |
|||
* 关闭视频,不释放底层资源 |
|||
@example |
|||
jessibuca.close(); |
|||
*/ |
|||
close(): void; |
|||
|
|||
/** |
|||
* 关闭视频,释放底层资源 |
|||
@example |
|||
jessibuca.destroy() |
|||
*/ |
|||
destroy(): void; |
|||
|
|||
/** |
|||
* 清理画布为黑色背景 |
|||
@example |
|||
jessibuca.clearView() |
|||
*/ |
|||
clearView(): void; |
|||
|
|||
/** |
|||
* 播放视频 |
|||
@example |
|||
|
|||
jessibuca.play('url').then(()=>{ |
|||
console.log('play success') |
|||
}).catch((e)=>{ |
|||
console.log('play error',e) |
|||
}) |
|||
//
|
|||
jessibuca.play() |
|||
*/ |
|||
play(url?: string): Promise<void>; |
|||
|
|||
/** |
|||
* 重新调整视图大小 |
|||
*/ |
|||
resize(): void; |
|||
|
|||
/** |
|||
* 设置最大缓冲时长,单位秒,播放器会自动消除延迟。 |
|||
* |
|||
* 等同于 `videoBuffer` 参数。 |
|||
* |
|||
@example |
|||
// 设置 200ms 缓冲
|
|||
jessibuca.setBufferTime(0.2) |
|||
*/ |
|||
setBufferTime(time: number): void; |
|||
|
|||
/** |
|||
* 设置旋转角度,只支持,0(默认) ,180,270 三个值。 |
|||
* |
|||
* > 可用于实现监控画面小窗和全屏效果,由于iOS没有全屏API,此方法可以模拟页面内全屏效果而且多端效果一致。 * |
|||
@example |
|||
jessibuca.setRotate(0) |
|||
|
|||
jessibuca.setRotate(90) |
|||
|
|||
jessibuca.setRotate(270) |
|||
*/ |
|||
setRotate(deg: number): void; |
|||
|
|||
/** |
|||
* |
|||
* 设置音量大小,取值0 — 1 |
|||
* |
|||
* > 区别于 mute 和 cancelMute 方法,虽然设置setVolume(0) 也能达到 mute方法,但是mute 方法是不调用底层播放音频的,能提高性能。而setVolume(0)只是把声音设置为0 ,以达到效果。 |
|||
* @param volume 当为0时,完全无声;当为1时,最大音量,默认值 |
|||
@example |
|||
jessibuca.setVolume(0.2) |
|||
|
|||
jessibuca.setVolume(0) |
|||
|
|||
jessibuca.setVolume(1) |
|||
*/ |
|||
setVolume(volume: number): void; |
|||
|
|||
/** |
|||
* 返回是否加载完毕 |
|||
@example |
|||
var result = jessibuca.hasLoaded() |
|||
console.log(result) // true
|
|||
*/ |
|||
hasLoaded(): boolean; |
|||
|
|||
/** |
|||
* 开启屏幕常亮,在手机浏览器上, canvas标签渲染视频并不会像video标签那样保持屏幕常亮。 |
|||
* H5目前在chrome\edge 84, android chrome 84及以上有原生亮屏API, 需要是https页面 |
|||
* 其余平台为模拟实现,此时为兼容实现,并不保证所有浏览器都支持 |
|||
@example |
|||
jessibuca.setKeepScreenOn() |
|||
*/ |
|||
setKeepScreenOn(): boolean; |
|||
|
|||
/** |
|||
* 全屏(取消全屏)播放视频 |
|||
@example |
|||
jessibuca.setFullscreen(true) |
|||
//
|
|||
jessibuca.setFullscreen(false) |
|||
*/ |
|||
setFullscreen(flag: boolean): void; |
|||
|
|||
/** |
|||
* |
|||
* 截图,调用后弹出下载框保存截图 |
|||
* @param filename 可选参数, 保存的文件名, 默认 `时间戳` |
|||
* @param format 可选参数, 截图的格式,可选png或jpeg或者webp ,默认 `png` |
|||
* @param quality 可选参数, 当格式是jpeg或者webp时,压缩质量,取值0 ~ 1 ,默认 `0.92` |
|||
* @param type 可选参数, 可选download或者base64或者blob,默认`download` |
|||
|
|||
@example |
|||
|
|||
jessibuca.screenshot("test","png",0.5) |
|||
|
|||
const base64 = jessibuca.screenshot("test","png",0.5,'base64') |
|||
|
|||
const fileBlob = jessibuca.screenshot("test",'blob') |
|||
*/ |
|||
screenshot(filename?: string, format?: string, quality?: number, type?: string): void; |
|||
|
|||
/** |
|||
* 开始录制。 |
|||
* @param fileName 可选,默认时间戳 |
|||
* @param fileType 可选,默认webm,支持webm 和mp4 格式 |
|||
|
|||
@example |
|||
jessibuca.startRecord('xxx','webm') |
|||
*/ |
|||
startRecord(fileName: string, fileType: string): void; |
|||
|
|||
/** |
|||
* 暂停录制并下载。 |
|||
@example |
|||
jessibuca.stopRecordAndSave() |
|||
*/ |
|||
stopRecordAndSave(): void; |
|||
|
|||
/** |
|||
* 返回是否正在播放中状态。 |
|||
@example |
|||
var result = jessibuca.isPlaying() |
|||
console.log(result) // true
|
|||
*/ |
|||
isPlaying(): boolean; |
|||
|
|||
/** |
|||
* 返回是否静音。 |
|||
@example |
|||
var result = jessibuca.isMute() |
|||
console.log(result) // true
|
|||
*/ |
|||
isMute(): boolean; |
|||
|
|||
/** |
|||
* 返回是否正在录制。 |
|||
@example |
|||
var result = jessibuca.isRecording() |
|||
console.log(result) // true
|
|||
*/ |
|||
isRecording(): boolean; |
|||
|
|||
|
|||
/** |
|||
* 监听 jessibuca 初始化事件 |
|||
* @example |
|||
* jessibuca.on("load",function(){console.log('load')}) |
|||
*/ |
|||
on(event: 'load', callback: () => void): void; |
|||
|
|||
/** |
|||
* 视频播放持续时间,单位ms |
|||
* @example |
|||
* jessibuca.on('timeUpdate',function (ts) {console.log('timeUpdate',ts);}) |
|||
*/ |
|||
on(event: 'timeUpdate', callback: () => void): void; |
|||
|
|||
/** |
|||
* 当解析出视频信息时回调,2个回调参数 |
|||
* @example |
|||
* jessibuca.on("videoInfo",function(data){console.log('width:',data.width,'height:',data.width)}) |
|||
*/ |
|||
on(event: 'videoInfo', callback: (data: { |
|||
/** 视频宽 */ |
|||
width: number; |
|||
/** 视频高 */ |
|||
height: number; |
|||
}) => void): void; |
|||
|
|||
/** |
|||
* 当解析出音频信息时回调,2个回调参数 |
|||
* @example |
|||
* jessibuca.on("audioInfo",function(data){console.log('numOfChannels:',data.numOfChannels,'sampleRate',data.sampleRate)}) |
|||
*/ |
|||
on(event: 'audioInfo', callback: (data: { |
|||
/** 声频通道 */ |
|||
numOfChannels: number; |
|||
/** 采样率 */ |
|||
sampleRate: number; |
|||
}) => void): void; |
|||
|
|||
/** |
|||
* 信息,包含错误信息 |
|||
* @example |
|||
* jessibuca.on("log",function(data){console.log('data:',data)}) |
|||
*/ |
|||
on(event: 'log', callback: () => void): void; |
|||
|
|||
/** |
|||
* 错误信息 |
|||
* @example |
|||
* jessibuca.on("error",function(error){ |
|||
if(error === Jessibuca.ERROR.fetchError){ |
|||
//
|
|||
} |
|||
else if(error === Jessibuca.ERROR.webcodecsH265NotSupport){ |
|||
//
|
|||
} |
|||
console.log('error:',error) |
|||
}) |
|||
*/ |
|||
on(event: 'error', callback: (err: Jessibuca.ERROR) => void): void; |
|||
|
|||
/** |
|||
* 当前网速, 单位KB 每秒1次, |
|||
* @example |
|||
* jessibuca.on("kBps",function(data){console.log('kBps:',data)}) |
|||
*/ |
|||
on(event: 'kBps', callback: (value: number) => void): void; |
|||
|
|||
/** |
|||
* 渲染开始 |
|||
* @example |
|||
* jessibuca.on("start",function(){console.log('start render')}) |
|||
*/ |
|||
on(event: 'start', callback: () => void): void; |
|||
|
|||
/** |
|||
* 当设定的超时时间内无数据返回,则回调 |
|||
* @example |
|||
* jessibuca.on("timeout",function(error){console.log('timeout:',error)}) |
|||
*/ |
|||
on(event: 'timeout', callback: (error: Jessibuca.TIMEOUT) => void): void; |
|||
|
|||
/** |
|||
* 当play()的时候,如果没有数据返回,则回调 |
|||
* @example |
|||
* jessibuca.on("loadingTimeout",function(){console.log('timeout')}) |
|||
*/ |
|||
on(event: 'loadingTimeout', callback: () => void): void; |
|||
|
|||
/** |
|||
* 当播放过程中,如果超过timeout之后没有数据渲染,则抛出异常。 |
|||
* @example |
|||
* jessibuca.on("delayTimeout",function(){console.log('timeout')}) |
|||
*/ |
|||
on(event: 'delayTimeout', callback: () => void): void; |
|||
|
|||
/** |
|||
* 当前是否全屏 |
|||
* @example |
|||
* jessibuca.on("fullscreen",function(flag){console.log('is fullscreen',flag)}) |
|||
*/ |
|||
on(event: 'fullscreen', callback: () => void): void; |
|||
|
|||
/** |
|||
* 触发播放事件 |
|||
* @example |
|||
* jessibuca.on("play",function(flag){console.log('play')}) |
|||
*/ |
|||
on(event: 'play', callback: () => void): void; |
|||
|
|||
/** |
|||
* 触发暂停事件 |
|||
* @example |
|||
* jessibuca.on("pause",function(flag){console.log('pause')}) |
|||
*/ |
|||
on(event: 'pause', callback: () => void): void; |
|||
|
|||
/** |
|||
* 触发声音事件,返回boolean值 |
|||
* @example |
|||
* jessibuca.on("mute",function(flag){console.log('is mute',flag)}) |
|||
*/ |
|||
on(event: 'mute', callback: () => void): void; |
|||
|
|||
/** |
|||
* 流状态统计,流开始播放后回调,每秒1次。 |
|||
* @example |
|||
* jessibuca.on("stats",function(s){console.log("stats is",s)}) |
|||
*/ |
|||
on(event: 'stats', callback: (stats: { |
|||
/** 当前缓冲区时长,单位毫秒 */ |
|||
buf: number; |
|||
/** 当前视频帧率 */ |
|||
fps: number; |
|||
/** 当前音频码率,单位bit */ |
|||
abps: number; |
|||
/** 当前视频码率,单位bit */ |
|||
vbps: number; |
|||
/** 当前视频帧pts,单位毫秒 */ |
|||
ts: number; |
|||
}) => void): void; |
|||
|
|||
/** |
|||
* 渲染性能统计,流开始播放后回调,每秒1次。 |
|||
* @param performance 0: 表示卡顿,1: 表示流畅,2: 表示非常流程 |
|||
* @example |
|||
* jessibuca.on("performance",function(performance){console.log("performance is",performance)}) |
|||
*/ |
|||
on(event: 'performance', callback: (performance: 0 | 1 | 2) => void): void; |
|||
|
|||
/** |
|||
* 录制开始的事件 |
|||
|
|||
* @example |
|||
* jessibuca.on("recordStart",function(){console.log("record start")}) |
|||
*/ |
|||
on(event: 'recordStart', callback: () => void): void; |
|||
|
|||
/** |
|||
* 录制结束的事件 |
|||
|
|||
* @example |
|||
* jessibuca.on("recordEnd",function(){console.log("record end")}) |
|||
*/ |
|||
on(event: 'recordEnd', callback: () => void): void; |
|||
|
|||
/** |
|||
* 录制的时候,返回的录制时长,1s一次 |
|||
|
|||
* @example |
|||
* jessibuca.on("recordingTimestamp",function(timestamp){console.log("recordingTimestamp is",timestamp)}) |
|||
*/ |
|||
on(event: 'recordingTimestamp', callback: (timestamp: number) => void): void; |
|||
|
|||
/** |
|||
* 监听调用play方法 经过 初始化-> 网络请求-> 解封装 -> 解码 -> 渲染 一系列过程的时间消耗 |
|||
* @param event |
|||
* @param callback |
|||
*/ |
|||
on(event: 'playToRenderTimes', callback: (times: { |
|||
playInitStart: number, // 1 初始化
|
|||
playStart: number, // 2 初始化
|
|||
streamStart: number, // 3 网络请求
|
|||
streamResponse: number, // 4 网络请求
|
|||
demuxStart: number, // 5 解封装
|
|||
decodeStart: number, // 6 解码
|
|||
videoStart: number, // 7 渲染
|
|||
playTimestamp: number,// playStart- playInitStart
|
|||
streamTimestamp: number,// streamStart - playStart
|
|||
streamResponseTimestamp: number,// streamResponse - streamStart
|
|||
demuxTimestamp: number, // demuxStart - streamResponse
|
|||
decodeTimestamp: number, // decodeStart - demuxStart
|
|||
videoTimestamp: number,// videoStart - decodeStart
|
|||
allTimestamp: number // videoStart - playInitStart
|
|||
}) => void): void |
|||
|
|||
/** |
|||
* 监听方法 |
|||
* |
|||
@example |
|||
|
|||
jessibuca.on("load",function(){console.log('load')}) |
|||
*/ |
|||
on(event: string, callback: Function): void; |
|||
|
|||
} |
|||
|
|||
export default Jessibuca; |
File diff suppressed because one or more lines are too long
Loading…
Reference in new issue