JSPM

  • Created
  • Published
  • Downloads 960
  • Score
    100M100P100Q102262F
  • License ISC

ezuikit javascript for npm

Package Exports

  • ezuikit-js
  • ezuikit-js/index.js
  • ezuikit-js/index.mjs

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (ezuikit-js) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

[EZUIKit-JavaScript-npm][ezuikit-js]

Download Version License Build Demos

轻应用 npm 版本,降低接入难度,适配自定义 UI,适配主流框架

低延时预览,云存储回放,SD 卡回放

功能 API 丰富,如:播放控制,音频控制,视频截图,实时获取视频 OSDTime,视频录制,设备对讲,电子放大,全屏等

hls和flv 不在维护更新,后续版本中会被移除, flv 可以使用 ezuikit-flv, hls 可以使用 @ezuikit/player-hls

hls和flv 不在维护更新,后续版本中会被移除, flv 可以使用 ezuikit-flv, hls 可以使用 @ezuikit/player-hls

hls和flv 不在维护更新,后续版本中会被移除, flv 可以使用 ezuikit-flv, hls 可以使用 @ezuikit/player-hls

获取 ezuikit-js

# npm
npm install ezuikit-js

# yarn

yarn add ezuikit-js

# pnpm

pnpm add ezuikit-js

引入 ezuikit-js

import EZUIKit from 'ezuikit-js';

如果你使用原生方法,可以通过标签引用

<!-- umd -->
<script src="./ezuikit.js"></script>

开始使用 - 初始化

基本使用

创建 DOM

<div id="video-container"></div>

播放器初始化

直播

const player = new EZUIKit.EZUIKitPlayer({
  id: 'video-container', // 视频容器ID
  accessToken: 'at.3bvmj4ycamlgdwgw1ig1jruma0wpohl6-48zifyb39c-13t5am6-yukyi86mz',
  url: 'ezopen://open.ys7.com/BD3957004/1.live',
  width: 600,
  height: 400,
  handleError: (err) => {
    if (err.type === 'handleRunTimeInfoError' && err.data.nErrorCode === 5) {
      // 加密设备密码错误
    }
  },
});

回放

const player = new EZUIKit.EZUIKitPlayer({
  id: 'video-container', // 视频容器ID
  width: 600,
  height: 400,
  accessToken: 'at.3bvmj4ycamlgdwgw1ig1jruma0wpohl6-48zifyb39c-13t5am6-yukyi86mz',
  url: 'ezopen://open.ys7.com/BD3957004/1.rec',
});

非正式版说明

alpha(功能测试)、beta(集成测试)为我们的非正式版本,可能存在功能或使用上的问题,若您遇到了任何问题,欢迎向我们反馈。

非正式版本没有 CDN 资源,使用时需要配置 staticPath,引用本地的解码库资源。

使用示例

如果使用原生 js,可参考 demos => base-demo

如果使用 react,可参考 demos => react-demo

如果使用 react + vite,可参考 demos => with-react-vite

如果使用 vue2,可参考 demos => vue-demo

如果使用 vue3,可参考 demos => vue3-demo

tips

为方便开发者快速接入

我们提供了测试 accessToken,测试播放地址,并提供了几种常用场景使用示例。你可以通过使用示例,使用测试播放地址,测试 accessToken,在你的应用快速接入。

测试播放地址: ezopen://open.ys7.com/BD3957004/1.live

你可以通过以下地址获取到测试 accessToken 获取测试 accessToken 用来播放上述测试播放地址。当前设备有可能下线或被移除了, 如果自己有设备优先使用自己的设备进行测试。

轻应用 - 海外版本

轻应用支持向接入萤石云海外环境的设备发起取流播放,需要在初始化时配置海外服务域名,示例:

const player = new EZUIKit.EZUIKitPlayer({
  id: 'playWind',
  width: 600,
  height: 400,
  template: 'pcLive',
  url: '',
  accessToken: '',
  env: {
    domain: 'https://iusopen.ezvizlife.com', // 北美地区
  },
});

各地区的域名分别为:

区域 域名
北美 https://iusopen.ezvizlife.com
南美 https://isaopen.ezvizlife.com
欧洲 https://ieuopen.ezvizlife.com
新加坡 https://isgpopen.ezvizlife.com
印度 https://iindiaopen.ezvizlife.com

最佳实践 tips

  1. 我们在 v0.6.2 及以上版本持用户通过开启谷歌实验室特性启动多线程解码,多线程模式将大大提升解码效率,降低解码内存消耗。

开启多线程方式 1(https://open.ys7.com/help/384)

开启多线程方式 2(https://open.ys7.com/help/385)

  1. 视频解码库默认从开放平台远程拉取,你可以将解码库放到本地或者你的服务内,可以提升加载解码库速度。

使用本地解码库提升加载速度 开发者需要自己设置静态资源文件地址, 参考 staticPath的配置

使用示例

  1. 快速创建视频播放页面

    基本使用: 基本使用示例

  1. 前往开放平台轻应用模板管理页创建一个主题,可以动态配置你的播放主题,控件,示例展示了获取一个主题后使用示例。

    自定义主题: 自定义主题示例

  1. 你可以本地创建一个主题配置,可以本地配置你的播放主题,控件,示例展示了本地配置项使用示例。

    本地主题配置: 本地主题配置示例

  1. 我们提供了一些通用场景的主题,PC 端预览,PC 端回放,移动端预览,移动端回放,你也可以直接使用。

    PC 端预览-固定主题: PC 端预览-固定主题示例

    PC 端回放-固定主题: PC 端回放-固定主题示例

    移动端预览-固定主题: 移动端预览-固定主题示例

    移动端回放-固定主题: 移动端回放-固定主题示例

同一个页面播放多个视频,可以参考:

    单页面多实例(视频多窗口): 单页面多实例(视频多窗口)示例

附录: 初始化参数说明

参数名类型描述是否必选
idString播放器容器DOM的idY
accessTokenString授权过程获取的access_tokenY
urlString

直播

标清

ezopen://open.ys7.com/${设备序列号}/{通道号}.live

高清

ezopen://open.ys7.com/${设备序列号}/{通道号}.hd.live

回放

sd 卡回放

初始化参数 url 值为:
ezopen://open.ys7.com/${设备序列号}/{通道号}.rec?begin=yyyyMMddhhmmss

云存储回放

初始化参数 url 值为:
ezopen://open.ys7.com/${设备序列号}/{通道号}.cloud.rec?begin=yyyyMMddhhmmss视频 ezopen 协议播放地址 详见:ezopen 协议

Y
audioboolean是否默认开启声音 true:打开(默认) false:关闭 N
widthint视频宽度,默认值为容器容器DOM宽度 Y
heightint视频高度,默认值为容器容器DOM高度Y
staticPathstring设置静态资源地址, 自定义可以自行下载 `ezuikit_static`放置在自己的服务器下, 设置 {staticPath: "/ezuikit_static"} N
templateString
模板值描述
simple极简版 *固定模板 仅包含视频播放窗口,创建实例后通过方法集控制视频播
放相关功能
standard标准版; *固定模板 包含视频窗口,叠加了停止,录制,全屏控件(通过
控件快捷调用方法集合控制视频播放相关功能,但你仍然可以通过方法集直接控制视频播放相关功
能。下同)
security安防版(预览回放); *固定模板 包含视频窗口,叠加了录制,全屏控件,
标清/高清切换,预览录制切换控件*
voice语音版; *固定模板 包含视频窗口,叠加了录制,全屏控件,语音播报,语音
对讲控件*
pcLive *固定模板 按钮列表,颜色,底部头部背景色固定,可用于pc端预览,如需
修改按钮配置,头部底部背景色,可参考 {{自定义themeId}},或者使用
themeData本地配置*
pcRec *固定模板 按钮列表,颜色,底部头部背景色固定, 可用于pc端回放,如需
修改按钮配置,头部底部背景色,可参考 {{自定义themeId}},或者使用themeData
本地配置*
mobileLive *固定模板 按钮列表,颜色,底部头部背景色固定,可用于移动端预
览,如需修改按钮配置,头部底部背景色,可参考 {{自定义themeId}},或者使用themeData
本地配置*
mobileRec*固定模板 按钮列表,颜色,底部头部背景色固定, 可用于移动端回放,
如需修改按钮配置,头部底部背景色,可参考 {{自定义themeId}},或者使用themeData
本地配置*
自定义themeId自定义主题,前往开放平台控制台配置页面获取
(v0.6.2版本及以上支持,建议使用 自定义themeId,或者使用themeData本地
配置);
N
themeDataObject themeData将主题数据本地化,设置本地数据,需要删除template参数
你可以通过themeData修改按钮位置,颜色,头部底部颜色等配置。

配置示例:



{
    "autoFocus": 5,
    "poster":"https://resource.eziot.com/group1/M00/00/89/CtwQEmLl8r-AZU7wAAETKlvgerU237.png",
    "header": {
        "color": "#1890ff",
        "activeColor": "#FFFFFF",
        "backgroundColor": "#000000",
        "btnList": [
            {
                "iconId": "deviceID",
                "part": "left",
                "defaultActive": 0,
                "memo": "顶部设备名称",
                "isrender": 1
            },
            {
                "iconId": "deviceName",
                "part": "left",
                "defaultActive": 0,
                "memo": "顶部设备ID",
                "isrender": 1
            },
            {
                "iconId": "cloudRec",
                "part": "right",
                "defaultActive": 0,
                "memo": "头部云存储回放",
                "isrender": 0
            },
            {
                "iconId": "rec",
                "part": "right",
                "defaultActive": 0,
                "memo": "头部本地回放",
                "isrender": 0
            }
        ]
    },
    "footer": {
        "color": "#FFFFFF",
        "activeColor": "#1890FF",
        "backgroundColor": "#00000021",
        "btnList": [
            {
                "iconId": "play",
                "part": "left",
                "defaultActive": 1,
                "memo": "播放",
                "isrender": 1
            },
            {
                "iconId": "capturePicture",
                "part": "left",
                "defaultActive": 0,
                "memo": "截屏按钮",
                "isrender": 1
            },
            {
                "iconId": "sound",
                "part": "left",
                "defaultActive": 0,
                "memo": "声音按钮",
                "isrender": 1
            },
            {
                "iconId": "pantile",
                "part": "left",
                "defaultActive": 0,
                "memo": "云台控制按钮",
                "isrender": 1
            },
            {
                "iconId": "recordvideo",
                "part": "left",
                "defaultActive": 0,
                "memo": "录制按钮",
                "isrender": 1
            },
            {
                "iconId": "talk",
                "part": "left",
                "defaultActive": 0,
                "memo": "对讲按钮",
                "isrender": 1
            },
            {
                "iconId": "zoom",
                "part": "left",
                "defaultActive": 0,
                "memo": "电子放大",
                "isrender": 1
            },
            {
                "iconId": "hd",
                "part": "right",
                "defaultActive": 0,
                "memo": "清晰度切换按钮",
                "isrender": 1
            },
            {
                "iconId": "webExpend",
                "part": "right",
                "defaultActive": 0,
                "memo": "网页全屏按钮",
                "isrender": 1
            },
            {
                "iconId": "expend",
                "part": "right",
                "defaultActive": 0,
                "memo": "全局全屏按钮",
                "isrender": 1
            }
        ]
    }
}
N
pluginString按需加载插件,可选值: talk:对讲,示例:plugin:["talk"] N
handleSuccessfunction自动播放成功回调N
handleErrorfunction错误回调N
seekFrequency function为避免频繁拖动播放异常,可设置模板回放时间轴拖动防抖间隔,默认值为2000(2秒),可取2000(2秒),3000(3秒),4000(4秒),5000(5秒)N
languageString多语言 (zh | en), 默认zh (v8.0.8版本及以上支持)N
debugDownloadDataboolean下载原始码流, 调试码流使用, 默认 false (v8.1.1版本及以上支持)N
disableRenderPrivateDataboolean禁止渲染私有数据(如智能分析, 移动侦测, 火点信息等), 默认 false (v8.1.1版本及以上支持)N
quality0 | 1 | 2 | 3 | 4 | 5 | 6 | pp | qp预览初始化支持指定清晰度进行播放, 默认 undefined (v8.1.5版本及以上支持), 0: 流畅; 1: 标清; 2: 高清; 3: 超清; 4: 极清; 5: 3K; 6: 4K ; "pp": "性能优先 (Performance Priority)"; "qp": "画质优先(Quality Priority)"。N
loggerOptions {name: string, level: "INFO" | "LOG" | "WARN" | "ERROR" , showTime: boolean}本地日志设置, 默认值 {name: "ezuikit", level: "INFO", showTime: true}, 支持动态设置请参考 setLoggerOptions(options) (v8.1.9版本及以上支持)N
streamInfoCBType 0 | 1 流信息回调类型,监听 streamInfoCB 事件, 0 : 每次都回调(会影响性能), 1 : 只回调一次, 默认值 1 (v8.1.9版本及以上支持)N

方法调用

同步方法(方式 1)方法支持通过 promise 回调,可通过回调方式执行下一步动作(方式 2)。

开始播放

// 方式1
player.play();
// 方式2
player.play().then(() => {
  console.log('执行播放成功后其他动作');
});

停止播放

// 方式1
player.stop();
// 方式2
player.stop().then(() => {
  console.log('执行停止成功后其他动作');
});

开启声音

// 方式1
player.openSound();
// 方式2
player.openSound().then(() => {
  console.log('执行开启声音成功后其他动作');
});

关闭声音

// 方式1
player.closeSound();

开始录制

因录制解码库加载限制,录制库加载需要 3S 秒左右,请保证录制时长需要大于 5 秒。录制文件需要使用播放器,播放器下载地址 播放器下载

// 方式1
player.startSave('唯一文件名');
// 方式2
player.startSave('唯一文件名').then(() => {
  console.log('执行开始录制成功后其他动作');
});

停止录制并下载文件

// 方式1
player.stopSave();
// 方式2
player.stopSave().then(() => {
  console.log('执行停止录制成功后其他动作');
});

抓图

// 方式1 - 下载到本地
player.capturePicture('文件名');
// 方式2 - 返回base64格式
const capCallback = (data) => {
  console.log('data', data);
};
player.capturePicture('default', capCallback);

开始对讲

player.startTalk();

结束对讲

player.stopTalk();

对讲设置麦克风增益

// 设置音频增益系数 0 ~ 10
player.setVolumeGain(volume);

获取麦克风权限

player.getMicrophonePermission().then((data) => {
  if (data.code === 0) {
    // 成功....
  }
});

获取麦克风列表

// 需要在麦克风已授权的情况下调用,才能获取到麦克风列表,可以和getMicrophonePermission配合使用,或在初始化后先调用getMicrophonePermission获取授权
player.getMicrophonesList().then((data) => {
  if (data.code === 0) {
    // 成功....
  }
});

切换麦克风

// microphoneId 为获取到的麦克风列表中的deviceId,如果当前处于对讲中,调用setProfile会先关闭,重新发起对讲
player.setProfile({ microphoneId });

监听麦克风音量变化

player.eventEmitter.on('volumeChange', ({ data }) => {
  // 动态显示音柱,100ms触发一次
  console.log(`${data * 100}%`);
});

全屏

player.fullScreen();

取消全屏

player.cancelFullScreen();

获取 OSD 时间

player.getOSDTime().then((time) => {
  console.log('获取到的当前播放时间', time);
});

切换地址播放

可用于在播放中切换设备,切换播放参数,以及直播切换回放等。请注意,频繁切换可能导致异常,切换间隔至少需要 1 秒

player.changePlayUrl(options).then(() => {
  console.log('切换成功');
});

options 参数说明

参数名 类型 是否必选 默认值 描述
type String Y 播放地址类型,"live":预览,"rec":回放;“cloud.rec”:云存储回放
deviceSerial String Y 设备序列号,存在英文字母的设备序列号,字母需为大写
channelNo int Y 通道号
accessToken String N 初始化时获取 授权过程获取的 access_token
hd boolean N 初始化时获取 是否为高清 true-主码流(高清) false-子码流(标清)
validCode String N 初始化时获取 设备验证码(加密设备播放需要输入验证码)
begin String N 初始化时获取 type 类型为回放有效,开始时间 格式为“YYYYMMDDHHmmss”
end String N 初始化时获取 type 类型为回放有效,结束时间 格式为 “YYYYMMDDHHmmss”

切换模板主题

可用于在播放中切换模板主题,请切换播放地址成功后调用

player.Theme.changeTheme(template);

// 预览切回放场景示例
player.changePlayUrl({ type: 'rec' }).then(() => {
  console.log('地址切换成功,开始切换模板主题');
  player.Theme.changeTheme('pcRec');
});

template 参数说明

参数名 类型 描述 是否必选
type String 模板名称,详见初始化参数 template Y

开启电子放大

建议使用模板,模板中的电子放大功能更全

// 方式1
player.enableZoom();
// 方式2
player.enableZoom().then(() => {
  console.log('开启电子放大成功');
});

关闭电子放大

// 方式1
player.closeZoom();
// 方式2
player.closeZoom().then(() => {
  console.log('关闭电子放大成功');
});

重置画面宽高

player.resize(width, height);

鱼眼矫正(软解 开启 SharedArrayBuffer

// {1, 0}  壁装鱼眼 不矫正
// {1, 1}  壁装360°全景
// {1, 2}  壁装4分屏
// {1, 4}  壁装广角
// {3, 0}  顶装鱼眼 不矫正
// {3, 1}  顶装360°全景
// {3, 4}  顶装4分屏
// {3, 5}  顶装柱状
// 顶装4分屏
player.setFECCorrectType({place: 3 , type:4}, "cavnas1,canvas2,canvas3") // cavnas1,canvas2,canvas3 是分屏是需要的

日志设置

//  interface LoggerOptions {
//   name?: string
//   level?: 'INFO' | 'LOG' | 'WARN' | 'ERROR',
//   showTime?: boolean
//  }
player.setLoggerOptions(options);

options 参数说明

参数名 类型 是否必选 默认值 描述
name string N 日志名称标签
level string N 日志等级, 支持 'INFO', 'LOG' , 'WARN' , 'ERROR' 四个等级
showTime boolean N 是否展示时间

事件

所有事件名 EZUIKitPlayer.EVENTS, 事件监听player.eventEmitter.on() 和事件取消 player.eventEmitter.off()

流信息事件

流信息事件 EZUIKitPlayer.EVENTS.streamInfoCB, 当初始化 streamInfoCBType = 1 时, 流信息事件只在获取到流时触发两次, 当初始化 streamInfoCBType = 0 时,会不停触发返回流信息(会影响性能)

// 监听流信息事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.streamInfoCB, (info) => {
  // 包括 视频信息 音频信息
  console.log('streamInfoCB', info);
});

音频信息事件

音频信息事件 EZUIKitPlayer.EVENTS.audioInfo

// interface AudioInfo {
//   audioFormatName:string // 音频格式名称
//   audioChannels:number // 音频通道数
//   audioBitsPerSample: number  // 音频采样位数
//   audioSamplesRate:number // 音频采样率
//   audioBitRate: number // 音频码率
// }
// 监听音频信息变化
player.eventEmitter.on(EZUIKitPlayer.EVENTS.audioInfo, (info) => {
  // {"audioFormat":8193,"audioFormatName":"AAC","audioChannels":1,"audioBitsPerSample":16,"audioSamplesRate":16000,"audioBitRate":32000}
  console.log('audioInfo', info);
});

备注:如果想一直获取音频信息是否变化,在初始化时这是 streamInfoCBType = 0

视频信息事件

音频信息事件 EZUIKitPlayer.EVENTS.videoInfo

// interface VideoInfo {
//   videoFormatName:string // 视频格式名称
//   width:number // 视频宽
//   height: number  // 视频高
//   frameRate:number // 帧率
//   intervalOfIFrame: number // IFrame间隔 (统计最近 5 个 GOP 的平均大小)
// }
// 监听视频信息变化
player.eventEmitter.on(EZUIKitPlayer.EVENTS.videoInfo, (info) => {
  // {"videoFormat":5,"videoFormatName":"H265","width":3840,"height":2160,"frameRate":15,"intervalOfIFrame":0}
  console.log('videoInfo', info);
});

备注:如果想一直获取视频信息是否变化,在初始化时这是 streamInfoCBType = 0

截图事件

截图事件 EZUIKitPlayer.EVENTS.capturePicture

// interface CapturePictureInfoDate {
//   fileName: string // 图片文件名称
//   base64: string // base64图片字符串
// }

// 监听截图事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.capturePicture, (info) => {
  // {data: CapturePictureInfoDate}
  console.log('capturePictureInfo', info);
});

截图事件

截图事件 EZUIKitPlayer.EVENTS.capturePicture

// interface CapturePictureInfoData {
//   fileName: string // 图片文件名称
//   base64: string // base64图片字符串
// }

// 监听截图事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.capturePicture, (info) => {
  // {data: CapturePictureInfoData}
  console.log('capturePictureInfo', info);
});

清晰度切换事件

截图事件 EZUIKitPlayer.EVENTS.changeVideoLevel

// interface VideoLevelData {
//   "name": string, // 清晰度名称
//   "level":2,   // 清晰度级别  0 | 1 | 2 | 3 | 4 | 5 | 6
//   "streamTypeIn":2  // 主子码流  1:主码流 2:子码流
// }
// 监听截图事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.changeVideoLevel, (info) => {
  // {data: VideoLevelData}
  console.log('changeVideoLevel', info);
});

打开关闭声音事件

打开声音事件 EZUIKitPlayer.EVENTS.openSound

// 监听打开声音事件, 默认音量是 0.8  暂时不支持更改
player.eventEmitter.on(EZUIKitPlayer.EVENTS.openSound, () => {
  // ...
});

关闭声音事件 EZUIKitPlayer.EVENTS.closeSound

// 监听关闭声音事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.closeSound, () => {
  // ...
});

解码资源加载事件

解码资源开始加载事件 EZUIKitPlayer.EVENTS.decoderLoad和解码资源加载完成事件 EZUIKitPlayer.EVENTS.decoderLoaded

// 监听解码资源开始加载事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.decoderLoad, () => {
  // ...
});
// 监听解码资源加载完成事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.decoderLoaded, () => {
  // ...
});

销毁事件

销毁事件 EZUIKitPlayer.EVENTS.destroy

// 监听销毁事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.destroy, () => {
  // ...
});

全屏相关事件

全屏事件 EZUIKitPlayer.EVENTS.fullscreen

// 监听全屏事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.fullscreen, () => {
  // ...
});

退出全屏事件 EZUIKitPlayer.EVENTS.exitFullscreen

// 监听退出全屏事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.exitFullscreen, () => {
  // ...
});

全屏变化事件 EZUIKitPlayer.EVENTS.fullscreenChange

// interface FullscreenChangeData {
//   "isCurrentFullscreen": boolean, // 全局全屏
//   "isCurrentBrowserFullscreen":boolean // 全局全屏和web 全屏
// }
// 监听全屏变化事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.fullscreenChange, (data) => {
  // {data: FullscreenChangeData}
  console.log('fullscreenChange', data);
});

首帧渲染事件

首帧渲染事件 EZUIKitPlayer.EVENTS.firstFrameDisplay

// 监听首帧渲染事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.firstFrameDisplay, () => {
  // ...
});

初始化事件

初始化事件 EZUIKitPlayer.EVENTS.init

// 监听初始化事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.init, () => {
  // ...
});

resize事件

resize事件事件 EZUIKitPlayer.EVENTS.resize

// 监听resize事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.resize, () => {
  // {data: {"width": number,"height":number}}
  console.log('resize', data);
});

暂停事件

暂停事件 EZUIKitPlayer.EVENTS.pause

// 监听暂停事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.pause, () => {
  // ...
});

播放事件

播放事件 EZUIKitPlayer.EVENTS.play

// 监听播放事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.play, () => {
  // ...
});

恢复播放事件

恢复播放事件 EZUIKitPlayer.EVENTS.resume, 仅支持回放

// 监听恢复播放事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.resume, () => {
  // ...
});

seek事件

seek事件 EZUIKitPlayer.EVENTS.seek, 仅支持回放

// 监听seek事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.seek, () => {
  // ...
});

停止播放事件

停止播放事件 EZUIKitPlayer.EVENTS.stop

// 监听停止播放事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.stop, () => {
  // ...
});

设置封面事件

设置封面事件 EZUIKitPlayer.EVENTS.setPoster

// 监听设置封面事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.setPoster, () => {
  // ...
});

设置镜像反转事件

设置镜像反转事件 EZUIKitPlayer.EVENTS.setMirrorFlip

// 监听设置镜像反转事件, 不判断是否成功
player.eventEmitter.on(EZUIKitPlayer.EVENTS.setMirrorFlip, (data) => {
  // ...
});

主题重置事件

主题重置事件 EZUIKitPlayer.EVENTS.reSetTheme

// 监听主题重置事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.reSetTheme, () => {
  // ...
});

回放时间变化事件

回放时间变化事件 EZUIKitPlayer.EVENTS.recTimeChange

// 监听回放时间变化事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.recTimeChange, () => {
  // ...
});

http 接口相关事件

获取云存储回片段事件 EZUIKitPlayer.EVENTS.http.getCloudRecTimes

// 监听获取云存储回片段事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.http.getCloudRecTimes, (list) => {
  // {data: {"width": number,"height":number}}
  console.log('list', list);
});

获取云录制回片段事件 EZUIKitPlayer.EVENTS.http.getCloudRecordTimes

// 监听获取云录制回片段事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.http.getCloudRecordTimes, (list) => {
  // {data: {"width": number,"height":number}}
  console.log('list', list);
});

获取本地录制回片段事件 EZUIKitPlayer.EVENTS.http.getLocalRecTimes

// 监听获取本地录制回片段事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.http.getLocalRecTimes, (list) => {
  // {data: {"width": number,"height":number}}
  console.log('list', list);
});

获取设备信息事件 EZUIKitPlayer.EVENTS.http.getDeviceInfo

// 监听获取设备信息事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.http.getDeviceInfo, (info) => {
  // {"deviceSerial":"BC7799091","deviceName":"前端设备勿动 C6Wi(BC7799091)","localName":"C6Wi(BC7799091)","model":"CS-C6Wi-8D8W2DF","status":1,"defence":0,"isEncrypt":0,"alarmSoundMode":2,"offlineNotify":0,"category":"C6Wi","parentCategory":"IPC","updateTime":1741763026000,"netType":"wireless","signal":"0%","riskLevel":0,"netAddress":"125.121.197.61"}
  console.log('info', info);
});

获取设备通道信息事件 EZUIKitPlayer.EVENTS.http.getDeviceList

// 监听获取设备信息事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.http.getDeviceList, (info) => {
  // {"deviceSerial":"BC7799091","deviceName":"前端设备勿动 C6Wi(BC7799091)","localName":"C6Wi(BC7799091)","model":"CS-C6Wi-8D8W2DF","status":1,"defence":0,"isEncrypt":0,"alarmSoundMode":2,"offlineNotify":0,"category":"C6Wi","parentCategory":"IPC","updateTime":1741763026000,"netType":"wireless","signal":"0%","riskLevel":0,"netAddress":"125.121.197.61"}
  console.log('info', info);
});

设置清晰度事件 EZUIKitPlayer.EVENTS.http.setVideoLevel

// 监听设置清晰度事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.http.setVideoLevel, () => {
  // ....
});

倍速相关事件

倍速增加事件 EZUIKitPlayer.EVENTS.fast

// 监听倍速增加事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.fast, ({ data }) => {
  console.log(data);
});

倍速下降事件 EZUIKitPlayer.EVENTS.fast

// 监听倍速下降事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.slow, ({ data }) => {
  console.log(data);
});

倍速变化事件 EZUIKitPlayer.EVENTS.speedChange

// 监听倍速变化事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.speedChange, (speed) => {
  console.log(speed);
});

对讲相关事件

开启对讲事件 EZUIKitPlayer.EVENTS.startTalk

// 监听开启对讲事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.startTalk, () => {
  // ...
});

关闭对讲事件 EZUIKitPlayer.EVENTS.stopTalk

// 监听关闭对讲事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.stopTalk, () => {
  // ...
});

对讲音量变化事件 EZUIKitPlayer.EVENTS.volumeChange

// 监听对讲音量变化事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.volumeChange, () => {
  // ...
});

对讲开启成功事件 EZUIKitPlayer.EVENTS.talkSuccess

// 监听对讲开启成功事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.talkSuccess, () => {
  // ...
});

对讲开启失败事件 EZUIKitPlayer.EVENTS.talkError

// 监听对讲开启失败事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.talkError, (error) => {
  // ...
  console.error('talkError', error);
});

录制相关事件

开启录制事件 EZUIKitPlayer.EVENTS.startSave

// 监听开启录制事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.startSave, () => {
  // ...
});

结束录制事件 EZUIKitPlayer.EVENTS.stopSave

// 监听结束录制事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.stopSave, ({ data }) => {
  // {"url":"blob:https://test12openstatic.ezv-test.com/80401d8c-3b5b-45d9-ba47-a79153fabbe9","file":{}}
  console.log(data);
});

电子放大相关事件

打开电子放大事件 EZUIKitPlayer.EVENTS.zoom.openZoom

// 监听打开电子放大事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.zoom.openZoom, () => {
  // ....
});

关闭电子放大事件 EZUIKitPlayer.EVENTS.zoom.closeZoom

// 监听关闭电子放大事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.zoom.closeZoom, () => {
  // ....
});

电子放大变化事件 EZUIKitPlayer.EVENTS.zoom.onZoomChange

// 监听电子放大变化事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.zoom.onZoomChange, (info) => {
  // {"zoom": string,"reset"?:boolean}
  console.log('onZoomChange', info);
});

云台控制相关事件

打开云台控制控件事件 EZUIKitPlayer.EVENTS.ptz.openPtz

// 监听开云台控制控件事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.ptz.openPtz, () => {
  // ...
});

关闭云台控制控件事件 EZUIKitPlayer.EVENTS.ptz.openPtz

// 监听关闭云台控制控件事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.ptz.closePtz, () => {
  // ...
});

云台控制速度变化事件 EZUIKitPlayer.EVENTS.ptz.ptzSpeedChange

// 监听关闭云台控制控件事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.ptz.ptzSpeedChange, () => {
  // ...
});

点击云台控制控件按钮事件 EZUIKitPlayer.EVENTS.ptz.ptzBtnClick

// 监听点击云台控制控件按钮事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.ptz.ptzBtnClick, () => {
  // ...
});

点击云台控制控件方向事件 EZUIKitPlayer.EVENTS.ptz.ptzDirection

// 监听点击云台控制控件方向事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.ptz.ptzDirection, () => {
  // ...
});

时间轴

时间轴控件宽度变化事件 EZUIKitPlayer.EVENTS.timeLine.timeWidthChange

// 监听点击云台控制控件方向事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.timeLine.timeWidthChange, (widthType) => {
  // ...
  console.log('timeWidthChange', widthType); // 0 | 1 | 2 | 3
});

日期选择器相关事件

日期选择器打开事件 EZUIKitPlayer.EVENTS.date.openDatePanel

// 监听日期选择器打开事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.date.openDatePanel, () => {
  // ...
});

日期选择器关闭事件 EZUIKitPlayer.EVENTS.date.closeDatePanel

// 监听日期选择器关闭事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.date.closeDatePanel, () => {
  // ...
});

日期选择器日期切换事件 EZUIKitPlayer.EVENTS.date.recStartTimeChange

// 监听日期选择器日期切换事件
player.eventEmitter.on(EZUIKitPlayer.EVENTS.date.recStartTimeChange, () => {
  // ...
});