ezuikit-js 8.2.7-beta.1 → 9.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +20 -0
- package/README.md +45 -37
- package/ezuikit.js +25 -25
- package/index.js +20 -20
- package/index.mjs +20 -20
- package/package.json +3 -3
package/CHANGELOG.md
CHANGED
|
@@ -1,3 +1,23 @@
|
|
|
1
|
+
### v9.0.1（2026-03-25）
|
|
2
|
+
|
|
3
|
+
#### Feat
|
|
4
|
+
|
|
5
|
+
- 支持取流超时取流链路异常断开重试
|
|
6
|
+
|
|
7
|
+
#### Fix
|
|
8
|
+
|
|
9
|
+
- 优化了取流失败返回的错误码
|
|
10
|
+
|
|
11
|
+
### v9.0.0（2026-03-18）
|
|
12
|
+
|
|
13
|
+
#### Feat
|
|
14
|
+
|
|
15
|
+
- 轻应用AI云存储重磅发布！
|
|
16
|
+
|
|
17
|
+
#### Fix
|
|
18
|
+
|
|
19
|
+
- 优化了H5端主题展示效果
|
|
20
|
+
|
|
1
21
|
### v8.2.7(2026-01-28)
|
|
2
22
|
|
|
3
23
|
#### Feat
|
package/README.md
CHANGED
|
@@ -127,11 +127,11 @@ alpha（功能测试）、beta（集成测试）为我们的非正式版本，
|
|
|
127
127
|
> 如果使用 vue2.7，可参考 demos => [vue-demo](https://github.com/Ezviz-OpenBiz/EZUIKit-JavaScript-npm/tree/master/demos/vue-demo)
|
|
128
128
|
|
|
129
129
|
> 如果使用 vue2.6，可参考 demos => [with-vue2.6](https://github.com/Ezviz-OpenBiz/EZUIKit-JavaScript-npm/tree/master/demos/with-vue2.6)
|
|
130
|
-
>
|
|
130
|
+
>
|
|
131
131
|
> 如果使用 uniapp + vue3 ，可参考 demos => [with-uniapp-vue3](https://github.com/Ezviz-OpenBiz/EZUIKit-JavaScript-npm/tree/master/demos/with-uniapp-vue3)
|
|
132
132
|
|
|
133
133
|
> 如果使用 uniapp + vue2 ，可参考 demos => [with-uniapp-vue2](https://github.com/Ezviz-OpenBiz/EZUIKit-JavaScript-npm/tree/master/demos/with-uniapp-vue2)
|
|
134
|
-
|
|
134
|
+
|
|
135
135
|
> 如果使用 docker + nginx ，可参考 demos => [with-docker-nginx](https://github.com/Ezviz-OpenBiz/EZUIKit-JavaScript-npm/tree/master/demos/with-docker-nginx)
|
|
136
136
|
|
|
137
137
|
#### tips
|
|
@@ -165,13 +165,13 @@ const player = new EZUIKitPlayer({
|
|
|
165
165
|
|
|
166
166
|
各地区的域名分别为：
|
|
167
167
|
|
|
168
|
-
| 区域
|
|
169
|
-
|
|
|
170
|
-
| 北美
|
|
171
|
-
| 南美
|
|
172
|
-
| 欧洲
|
|
168
|
+
| 区域 | 域名 |
|
|
169
|
+
| --- | -------------------------------- |
|
|
170
|
+
| 北美 | https://iusopen.ezvizlife.com |
|
|
171
|
+
| 南美 | https://isaopen.ezvizlife.com |
|
|
172
|
+
| 欧洲 | https://ieuopen.ezvizlife.com |
|
|
173
173
|
| 新加坡 | https://isgpopen.ezvizlife.com |
|
|
174
|
-
| 印度
|
|
174
|
+
| 印度 | https://iindiaopen.ezvizlife.com |
|
|
175
175
|
|
|
176
176
|
#### 最佳实践 tips
|
|
177
177
|
|
|
@@ -242,8 +242,8 @@ ezopen://open.ys7.com/${设备序列号}/{通道号}.hd.live<br/>
|
|
|
242
242
|
初始化参数 url 值为：<br/> ezopen://open.ys7.com/${设备序列号}/{通道号}.cloud.rec?begin=yyyyMMddhhmmss 视频 ezopen 协议播放地址 详见：<a href="https://open.ys7.com/help/23" target="_blank">ezopen 协议</a> </td><td>Y</td></tr>
|
|
243
243
|
|
|
244
244
|
<tr><td>audio</td><td>boolean</td><td>是否默认开启声音 true：打开（默认） false：关闭 </td><td>N</td></tr>
|
|
245
|
-
<tr><td>width</td><td>
|
|
246
|
-
<tr><td>height</td><td>
|
|
245
|
+
<tr><td>width</td><td>number/string</td><td>视频窗口宽度，默认值为容器容器DOM宽度, @sine 8.2.x 开始支持字符串，可以是 style 样式支持的值</td><td>N</td></tr>
|
|
246
|
+
<tr><td>height</td><td>number/string</td><td>视频窗口高度，默认值为容器容器DOM高度，@sine 8.2.x 开始支持字符串，可以是 style 样式支持的值</td><td>N</td></tr>
|
|
247
247
|
<tr><td>staticPath</td><td>string</td><td>设置静态资源地址, 自定义可以自行下载 `ezuikit_static`放置在自己的服务器下， 设置 {staticPath: "/ezuikit_static"} </td><td>N</td></tr>
|
|
248
248
|
<tr><td>template</td><td>String</td><td>
|
|
249
249
|
|
|
@@ -252,7 +252,6 @@ ezopen://open.ys7.com/${设备序列号}/{通道号}.hd.live<br/>
|
|
|
252
252
|
|
|
253
253
|
<tr><td>simple</td><td>极简版 *固定模板 仅包含视频播放窗口，创建实例后通过方法集控制视频播<br />放相关功能</td></tr>
|
|
254
254
|
|
|
255
|
-
|
|
256
255
|
<tr><td>security</td><td>安防版(预览回放); *固定模板 包含视频窗口，叠加了录制，全屏控件，<br />标清/高清切换，预览录制切换控件*</td></tr>
|
|
257
256
|
<tr><td>voice</td><td>语音版; *固定模板 包含视频窗口，叠加了录制，全屏控件，语音播报，语音<br />对讲控件*</td></tr>
|
|
258
257
|
<tr><td>pcLive</td><td> *固定模板 按钮列表，颜色，底部头部背景色固定，可用于pc端预览，如需<br />修改按钮配置，头部底部背景色，可参考 {{自定义themeId}}，或者使用<br />themeData本地配置*</td></tr>
|
|
@@ -292,7 +291,7 @@ themeData将主题数据本地化，设置本地数据，需要删除template参
|
|
|
292
291
|
<tr><td><a href="./cloudRecord.md">spaceId</a></td><td> number</td><td> 云录制空间 ID (仅云录制生效) @sine 8.2.0 </td><td>N</td></tr>
|
|
293
292
|
<tr><td>timeLineOptions</td><td> Object </td><td><code>{
|
|
294
293
|
showCoverFold: true, // 是否展示移动端卡片 默认 true @sine 8.2.1 <br/>
|
|
295
|
-
showTimeWidthBtn: true, // 是否展示移动端时间刻度宽度 默认 true @sine 8.2.1
|
|
294
|
+
showTimeWidthBtn: true, // 是否展示移动端时间刻度宽度 默认 true， @sine 8.2.1
|
|
296
295
|
}</code></td><td>N</td></tr>
|
|
297
296
|
|
|
298
297
|
<tr><td>speedOptions</td><td> Object </td><td><code>
|
|
@@ -302,6 +301,7 @@ themeData将主题数据本地化，设置本地数据，需要删除template参
|
|
|
302
301
|
<br/>
|
|
303
302
|
}
|
|
304
303
|
</code></td><td>N</td></tr>
|
|
304
|
+
<tr><td>dblClickFullscreen</td><td> boolean </td><td>是否支持双击全屏，默认 true, @sine 8.2.0</td><td>N</td></tr>
|
|
305
305
|
</table>
|
|
306
306
|
|
|
307
307
|
### 方法调用
|
|
@@ -443,14 +443,14 @@ player.eventEmitter.on("volumeChange", ({ data }) => {
|
|
|
443
443
|
#### 全屏
|
|
444
444
|
|
|
445
445
|
```js
|
|
446
|
-
player.fullScreen(); // 8.2.0 开始移除
|
|
446
|
+
player.fullScreen(); // 8.2.0 开始移除
|
|
447
447
|
player.fullscreen(); // 8.2.0 新增
|
|
448
448
|
```
|
|
449
449
|
|
|
450
450
|
#### 取消全屏
|
|
451
451
|
|
|
452
452
|
```js
|
|
453
|
-
player.cancelFullScreen(); // 8.2.0 开始移除
|
|
453
|
+
player.cancelFullScreen(); // 8.2.0 开始移除
|
|
454
454
|
player.exitFullscreen(); // 8.2.0 新增
|
|
455
455
|
```
|
|
456
456
|
|
|
@@ -474,23 +474,23 @@ player.changePlayUrl(options).then(() => {
|
|
|
474
474
|
|
|
475
475
|
options 参数说明
|
|
476
476
|
|
|
477
|
-
| 参数名
|
|
478
|
-
|
|
479
|
-
| type | String | Y
|
|
480
|
-
| deviceSerial | String | Y
|
|
481
|
-
| channelNo | int | Y
|
|
482
|
-
| accessToken | String | N
|
|
483
|
-
| hd | boolean | N
|
|
484
|
-
| validCode | String | N
|
|
485
|
-
| begin | String | N
|
|
486
|
-
| end | String | N
|
|
477
|
+
| 参数名 | 类型 | 是否必选 | 默认值 | 描述 |
|
|
478
|
+
|:------------ |:------- |:---- |:------ |:------------------------------------------- |
|
|
479
|
+
| type | String | Y | 无 | 播放地址类型，"live":预览，"rec"：回放；“cloud.rec”：云存储回放 |
|
|
480
|
+
| deviceSerial | String | Y | 无 | 设备序列号,存在英文字母的设备序列号，字母需为大写 |
|
|
481
|
+
| channelNo | int | Y | 无 | 通道号 |
|
|
482
|
+
| accessToken | String | N | 初始化时获取 | 授权过程获取的 access_token |
|
|
483
|
+
| hd | boolean | N | 初始化时获取 | 是否为高清 true-主码流（高清） false-子码流(标清) |
|
|
484
|
+
| validCode | String | N | 初始化时获取 | 设备验证码（加密设备播放需要输入验证码） |
|
|
485
|
+
| begin | String | N | 初始化时获取 | type 类型为回放有效，开始时间 格式为“YYYYMMDDHHmmss” |
|
|
486
|
+
| end | String | N | 初始化时获取 | type 类型为回放有效，结束时间 格式为 “YYYYMMDDHHmmss” |
|
|
487
487
|
|
|
488
488
|
#### 切换模板主题
|
|
489
489
|
|
|
490
490
|
> 可用于在播放中切换模板主题，请切换播放地址成功后调用
|
|
491
491
|
|
|
492
492
|
```js
|
|
493
|
-
player.Theme.changeTheme(template); // 8.2.0 开始移除
|
|
493
|
+
player.Theme.changeTheme(template); // 8.2.0 开始移除
|
|
494
494
|
|
|
495
495
|
player.changeTheme(template); // 8.2.0 新增
|
|
496
496
|
|
|
@@ -504,9 +504,9 @@ player.changePlayUrl({ type: "rec" }).then(() => {
|
|
|
504
504
|
|
|
505
505
|
template 参数说明
|
|
506
506
|
|
|
507
|
-
| 参数名
|
|
508
|
-
|
|
509
|
-
| type
|
|
507
|
+
| 参数名 | 类型 | 描述 | 是否必选 |
|
|
508
|
+
|:---- |:------ |:--------------------- |:---- |
|
|
509
|
+
| type | String | 模板名称，详见初始化参数 template | Y |
|
|
510
510
|
|
|
511
511
|
#### 开启电子放大
|
|
512
512
|
|
|
@@ -566,11 +566,11 @@ player.setLoggerOptions(options);
|
|
|
566
566
|
|
|
567
567
|
options 参数说明
|
|
568
568
|
|
|
569
|
-
| 参数名
|
|
570
|
-
|
|
571
|
-
| name | string | N
|
|
572
|
-
| level | string | N
|
|
573
|
-
| showTime | boolean | N
|
|
569
|
+
| 参数名 | 类型 | 是否必选 | 默认值 | 描述 |
|
|
570
|
+
|:-------- |:------- |:---- |:--- |:---------------------------------------------- |
|
|
571
|
+
| name | string | N | 无 | 日志名称标签 |
|
|
572
|
+
| level | string | N | 无 | 日志等级， 支持 'INFO', 'LOG' , 'WARN' , 'ERROR' 四个等级 |
|
|
573
|
+
| showTime | boolean | N | 无 | 是否展示时间 |
|
|
574
574
|
|
|
575
575
|
## 事件
|
|
576
576
|
|
|
@@ -777,8 +777,6 @@ player.eventEmitter.on(EZUIKitPlayer.EVENTS.fullscreenChange, (info) => {
|
|
|
777
777
|
});
|
|
778
778
|
```
|
|
779
779
|
|
|
780
|
-
|
|
781
|
-
|
|
782
780
|
#### 首帧渲染事件
|
|
783
781
|
|
|
784
782
|
首帧渲染事件 `EZUIKitPlayer.EVENTS.firstFrameDisplay`
|
|
@@ -936,7 +934,7 @@ player.eventEmitter.on(
|
|
|
936
934
|
(list) => {
|
|
937
935
|
// {data: {"width": number,"height":number}}
|
|
938
936
|
console.log("list", list);
|
|
939
|
-
}
|
|
937
|
+
},
|
|
940
938
|
);
|
|
941
939
|
```
|
|
942
940
|
|
|
@@ -1165,7 +1163,7 @@ player.eventEmitter.on(
|
|
|
1165
1163
|
(widthType) => {
|
|
1166
1164
|
// ...
|
|
1167
1165
|
console.log("timeWidthChange", widthType); // 0 | 1 | 2 | 3
|
|
1168
|
-
}
|
|
1166
|
+
},
|
|
1169
1167
|
);
|
|
1170
1168
|
```
|
|
1171
1169
|
|
|
@@ -1200,13 +1198,23 @@ player.eventEmitter.on(EZUIKitPlayer.EVENTS.date.recStartTimeChange, () => {
|
|
|
1200
1198
|
|
|
1201
1199
|
<!-- | 事件名 （Event） | 返回值 | 描述 Description |
|
|
1202
1200
|
| :------------------ | :-------------------------------------------------------------------------------------------------------- | :----------------------- | -->
|
|
1201
|
+
|
|
1203
1202
|
<!-- | changePlayUrl | boolean | N 示时间 | -->
|
|
1203
|
+
|
|
1204
1204
|
<!-- | changeZoomType | boolean | N 示时间 | -->
|
|
1205
|
+
|
|
1205
1206
|
<!-- | close3DZoom | boolean | N 示时间 | -->
|
|
1207
|
+
|
|
1206
1208
|
<!-- | enable3DZoom | boolean | N 示时间 | -->
|
|
1209
|
+
|
|
1207
1210
|
<!-- | getDeviceCapacity | boolean | N 示时间 | -->
|
|
1211
|
+
|
|
1208
1212
|
<!-- | getOSDTime | boolean | N 示时间 | -->
|
|
1213
|
+
|
|
1209
1214
|
<!-- | getPlayRate | boolean | N 示时间 | -->
|
|
1215
|
+
|
|
1210
1216
|
<!-- | getPtzStatus | boolean | N 示时间 | -->
|
|
1217
|
+
|
|
1211
1218
|
<!-- | getVideoLevel | boolean | N 示时间 | -->
|
|
1219
|
+
|
|
1212
1220
|
<!-- | getVideoLevelList | boolean | N 示时间 | -->
|