文档 属性·动作·事件
功能概述
视频流组件是一个强大的多媒体处理工具，允许用户获取本地视频流并在组件中展示。它支持多种媒体源，包括本地视频文件、屏幕共享和摄像头设备。用户可以通过各种动作控制视频流的获取、显示和录制，并能够获取媒体内容的 blob 数据。
主要特性
• 支持多种媒体源：本地视频、屏幕共享、摄像头• 提供实时预览功能
• 支持视频帧捕获和视频片段录制
• 提供丰富的控制动作和触发事件
事件
视频流组件包含 2 个特有的触发事件：• 开始记录事件：当开始录制视频时触发
• 停止记录事件：当停止录制视频时触发
动作
视频流组件提供了 11 个动作，分为以下几类：获取视频流动作：
打开本地视频
• 功能：打开一个本地视频文件，并在视频流组件中播放
• 使用场景：需要展示或处理本地存储的视频文件时
获取设备屏幕
• 功能：选择并共享特定屏幕或窗口，在视频流组件中实时显示
• 使用场景：进行屏幕演示或远程协作时
获取媒体设备
• 功能：获取摄像头等设备的访问权限，并在视频流组件中显示画面
• 使用场景：视频会议、直播等需要使用摄像头的场合
关闭视频流动作：
关闭本地视频流
• 功能：关闭当前正在使用的屏幕共享或摄像头共享
• 使用场景：结束屏幕共享或视频通话时
视频帧操作动作：
开启获取视频帧
• 功能：准备捕获视频的单帧画面
• 使用场景：需要分析或保存视频特定帧时
结束获取视频帧
• 功能：完成视频帧的捕获，获取当前帧的 blob 文件
• 选项：可设置是否自动下载捕获的帧
• 使用场景：需要保存或进一步处理捕获的视频帧时
获取当前帧
• 功能：立即捕获并获取当前视频帧，相当于上述两个动作的组合
• 选项：可设置是否自动下载捕获的帧
• 使用场景：快速获取当前画面的截图时
视频录制操作动作：
开始记录
• 功能：开始录制当前视频流的视频内容
• 触发：执行时会触发”开始记录事件”
• 使用场景：需要保存一段视频内容时
暂停记录
• 功能：暂时停止视频录制，但不结束整个录制过程
• 使用场景：需要在录制过程中暂停以跳过不需要的部分时
继续记录
• 功能：从暂停状态恢复视频录制
• 使用场景：配合”暂停记录”使用，继续之前的录制
停止记录
• 功能：结束整个视频录制过程
• 触发：执行时会触发”停止记录事件”
• 选项：可设置是否自动下载录制的视频（MP4格式）
• 使用场景：完成一段视频的录制并获取录制文件时
清空内存地址
• 功能：清空内存
使用流程示例
• 选择媒体源（打开本地视频/获取设备屏幕/获取屏幕设备）• 在视频流组件中预览内容
• 根据需求选择：
- 捕获单帧：使用视频帧操作相关动作
- 录制视频片段：使用视频录制操作相关动作
- • 处理获取到的媒体内容（下载、further处理等）
- • 完成后关闭本地视频流
注意事项
• 使用摄像头或屏幕共享功能时，需要用户授予相应的权限• 录制的视频默认保存为 MP4 格式
• 在使用获取帧或录制功能时，请确保遵守相关的隐私和版权法规
属性
视频流
文档 属性·动作·事件 属性 动作 事件
排版设置
属性名称 属性类型 属性说明 外边距上 数值 当前组件上边框与其上方元素之间的距离。继承自：
ih5-base 外边距下 数值 当前组件下边框与其下方元素之间的距离。继承自：
ih5-base 外边距左 数值 当前组件左边框与其左侧元素之间的距离。继承自：
ih5-base 外边距右 数值 当前组件右边框与其右侧元素之间的距离。继承自：
ih5-base 最大宽度 px/% 当前组件参与相对布局时随窗口自动调整宽度的最大值，可设定为固定像素或比例。继承自：
ih5-base 最小宽度 px/% 当前组件参与相对布局时随窗口自动调整宽度的最小值，可设定为固定像素或比例。继承自：
ih5-base 最大高度 px/% 当前组件参与相对布局时随窗口自动调整高度的最大值，可设定为固定像素或比例。继承自：
ih5-base 最小高度 px/% 当前组件参与相对布局时随窗口自动调整高度的最小值，可设定为固定像素或比例。继承自：
ih5-base 堆叠次序 数值 当前组件的堆叠顺序，即“z轴”上的叠放次序。堆叠次序是一个整数，可以为负。数值越高的组件，会相对同一个父节点的下的其他对象，叠放在更上面。在ivx中，绝对定位环境下，我们可以通过对象树中的顺序来设置对象的堆叠次序，但在相对定位环境中，由于对象默认是流式布局，在对象有重叠的情况下，我们可以通过堆叠次序来手动调整对象之间的重叠关系。继承自：
ih5-base旋转设置
属性名称 属性类型 属性说明 X原点 百分比 当前组件原点的X坐标位置，默认为0，即水平方向的最左端，设置为1则为组件的最右端。组件发生旋转时，原点是组件旋转的中心点。继承自：
ih5-base Y原点 百分比 当前组件原点的Y坐标位置，默认为0，即竖直方向的最上端，设置为1则为组件的最下端。组件发生旋转时，原点是组件旋转的中心点。继承自：
ih5-base 旋转角度 角度 当前组件的旋转角度，默认为0度，即不旋转，可设置范围为0°~360°。继承自：
ih5-base手势控制
属性名称 属性类型 属性说明 拖动方式 选项 在绝对定位环境下的组件，是否可让用户拖动。可选任意方向拖动，或固定方向拖动。注意，拖动对象，会强行改变对象的x、y位置，如果对象本身添加了动效或轨迹，可能会冲突。建议允许拖动的对象本身不要添加任何动画，但可以为其子对象添加动画效果，避免冲突。继承自：
ih5-base 拖动边界 开关 打开拖动边界后，对象只能在父层容器的范围内进行拖动。继承自：
ih5-base 双指放缩 开关继承自：
ih5-base 双指旋转 开关继承自：
ih5-base边框与圆角
属性名称 属性类型 属性说明 边框圆角 px/% 当前组件矩形边框的圆角对应的圆半径大小。（绑定数值或文本时需要加上单位px：变量+’px’）继承自：
ih5-base 圆角位置 多项选项 当前组件矩形边框的圆角位置，默认四个圆角都为开启状态，可点击选择保留或去除某一角的圆角。当需要通过变量绑定控制显示时，需将其视为一个四位的二进制数，以位置左上、右上、右下、左下的顺序，依次对应第一二三四位，如点亮左上与右上，对应二进制数是0011，转为十进制后是3，因此绑定数值3可以实现只显示左上右上圆角的效果。继承自：
ih5-base 边框宽度 数值 当前组件矩形边框的宽度。继承自：
ih5-base 边框类型 选项 当前组件矩形边框的线条类型，包含：实线（默认）、虚线、点状边框和无边框。继承自：
ih5-base 边框颜色 颜色 当前组件矩形边框的颜色。继承自：
ih5-base 边框位置 多项选项 当前组件矩形边框的显示位置，可通过点击选择不同的边框，可只保留下边框实现下划线样式。当需要通过变量绑定控制显示时，需将其视为一个四位的二进制数，以边框上右下左的顺序，依次对应第一二三四位，如点亮上右，对应二进制数是0011，转为十进制后是3，因此绑定数值3可以实现只显示上右边框的效果。继承自：
ih5-base阴影设置
属性名称 属性类型 属性说明 阴影类型 选项 当前组件阴影的不同呈现类，可设置为边框阴影（默认）或投射阴影。继承自：
ih5-base 阴影偏X 数值 当前组件阴影的水平方向偏移值，正为偏右，负为偏左。继承自：
ih5-base 阴影偏Y 数值 当前组件阴影的竖直方向偏移值，正为偏下，负为偏上。继承自：
ih5-base 阴影模糊 数值 当前组件阴影模糊的范围大小。继承自：
ih5-base 阴影颜色 颜色 当前组件阴影的颜色。继承自：
ih5-base滤镜效果
属性名称 属性类型 属性说明 模糊 数值 当前组件本身的模糊程度，值越大越模糊。继承自：
ih5-base 亮度 百分比 当前组件内色彩的亮度高低。属性面板直接设置时范围值为1~100的百分比，在事件面板设置时需填入小数，范围为0~1。继承自：
ih5-base 对比度 百分比 当前组件内色彩的对比度高低。属性面板直接设置时范围值为1~100的百分比，在事件面板设置时需填入小数，范围为0~1。继承自：
ih5-base 饱和度 百分比 当前组件内色彩的饱和度高低。属性面板直接设置时范围值为1~100的百分比，在事件面板设置时需填入小数，范围为0~1。继承自：
ih5-base 灰度 百分比 当前组件内色彩的灰度高低。属性面板直接设置时范围值为1~100的百分比，在事件面板设置时需填入小数，范围为0~1。继承自：
ih5-base 反转图像 百分比 将当前组件内颜色显示为其对应的反转色，纯黑会反转为纯白，可设置不同百分比的反转程度。继承自：
ih5-base 色相旋转 角度 将当前组件的颜色显示为其按色环旋转一定角度后对应的颜色，旋转角度为0°~360°。继承自：
ih5-base其它
属性名称 属性类型 属性说明 开关继承自：
ih5-base事件
事件表
事件名称 事件说明 事件参数 事件参数说明 初始化 初始打开，功能和界面在正常运行前的准备阶段。继承自：
ih5-base -/- 点击 鼠标单击或手指点击组件或其子组件时触发。继承自：
ih5-base X坐标 指针相对于页面的X坐标。 Y坐标 指针相对于页面的Y坐标。 双击 鼠标双击或手指双击组件或其子组件时触发。继承自：
ih5-base X坐标 指针相对于页面的X坐标。 Y坐标 指针相对于页面的Y坐标。 长按（0.35秒） 鼠标长按或手指长按组件至0.35秒时触发，如果不足此时间则不触发。继承自：
ih5-base -/- 点击右键 鼠标右键点击组件或其子组件时触发。继承自：
ih5-base X坐标 指针相对于页面的X坐标。 Y坐标 指针相对于页面的Y坐标。 鼠标滚轮上滑 鼠标指针处于当前组件内，滚轮上滑时触发。继承自：
ih5-base -/- 鼠标滚轮下滑 鼠标指针处于当前组件内，滚轮下滑时触发。继承自：
ih5-base -/- 手指按下 移动设备上，手指在当前组件范围内按下的瞬间触发。继承自：
ih5-base X坐标 指针相对于页面的X坐标。 Y坐标 指针相对于页面的Y坐标。 手指离开 移动设备上，手指在当前组件范围内松开的瞬间触发。继承自：
ih5-base X坐标 指针相对于页面的X坐标。 Y坐标 指针相对于页面的Y坐标。 手指/鼠标移动 手指或鼠标在当前组件范围内向任意方向移动时触发。注意，如果是鼠标操作，则需要鼠标在当前组件范围内按下，并保持按下状态进行移动才会触发。事件触发后，即使手指或鼠标移出当前组件范围，事件依旧会处在触发状态。继承自：
ih5-base X坐标 鼠标指针相对于当前窗口的左上角的X坐标。 Y坐标 鼠标指针相对于当前窗口的左上角的Y坐标。 任何方向滑动 手指或鼠标左键在当前组件范围内向任意方向滑动结束时触发。继承自：
ih5-base 滑动方向 滑动的方向，用角度表示。 滑动速度 滑动的速度。 滑动距离 滑动的距离。 左滑 手指在组件范围内向左滑动时触发。继承自：
ih5-base -/- 右滑 手指在组件范围内向右滑动时触发。继承自：
ih5-base -/- 上滑 手指在组件范围内向上滑动时触发。继承自：
ih5-base -/- 下滑 手指在组件范围内向下滑动时触发。继承自：
ih5-base -/- 双指旋转继承自：
ih5-base 旋转中心X 单位为像素，和对象的x、y坐标一样，以对象的父对象作为参照物。 旋转中心Y 单位为像素，和对象的x、y坐标一样，以对象的父对象作为参照物。 旋转角度 双指旋转的角度 双指放缩继承自：
ih5-base 放缩中心X 单位为像素，和对象的x、y坐标一样，以对象的父对象作为参照物。 放缩中心Y 单位为像素，和对象的x、y坐标一样，以对象的父对象作为参照物。 水平放缩比 水平方向的放缩比例 垂直放缩比 垂直方向的放缩比例 鼠标悬浮移动 在不按下左键的情况下，鼠标指针移动的事件。会抛出当前鼠标的位置。继承自：
ih5-base X坐标 Y坐标 开始录制 -/- 停止录制动作
动作（名称与参数）表
动作名称 动作说明 动作参数 动作参数说明 显示 组件从隐藏状态切换到显示状态。继承自：
ih5-base -/- 隐藏 组件从显示状态切换到隐藏状态。继承自：
ih5-base -/- 交替显示 组件执行“显示—隐藏”的交替动作，当前如是显示状态，则变为隐藏；反之亦然。继承自：
ih5-base -/- 打印为图片 类似打印画布，将当前组件的内容打印成一个base64的图。使用html2canvas这个打印库。这个库的原理是将当前html结构在一个隐藏的canvas画布上重构出来，然后打印这个隐藏canvas的图。它目前的功能基本上可以把所有的样式都打印出来，但暂时存在一些已知的缺陷，比如，无法打印视频中的帧，无法打印虚线边框，文本高亮之后打印后会有问题，文本最大行数设置后打印会不显示文字，不支持文本的自定义字体（但可以使用中文字体来代替普通文本，中文字体是后台生成的图片，可以直接打印）。建议使用该功能时，尽量不要使用复杂的样式，另外，详细测试一下pc、ios、安卓手机中的行为。继承自：
ih5-base 图片格式参数选项
image/png、 image/jpeg、 图片质量 放缩比例 默认根据设备dpi自动设置，也可以手动设为固定值。 变换状态 将对象的某些属性以动画的方式变换至另一个状态。比如，宽高，透明度常见的样式属性。继承自：
ih5-base 变换时长 动画持续的时长，以秒为单位。 动画类型 变换动画的速度曲线参数选项
匀速、 较快->快->慢、 慢->快、 快->慢、 慢->快->慢、 获取当前实际宽|实际宽 组件当前实际的宽，以像素为单位。由于组件可能是自动包裹/撑开，或通过缩放，因此其宽高属性并不一定能反应其当前实际的大小。可以使用这个属性来获取其实际宽。继承自：
ih5-base -/- 获取当前实际高|实际高 组件当前实际的高，以像素为单位。由于组件可能是自动包裹/撑开，或通过缩放，因此其宽高属性并不一定能反应其当前实际的大小。可以使用这个属性来获取其实际高。继承自：
ih5-base -/- 获取当前相对位置|相对位置 当前元素距离其父对象容器左侧、顶部的距离。继承自：
ih5-base -/- 获取当前绝对位置|绝对位置 当前元素距离窗口左侧、顶部的距离。继承自：
ih5-base -/- 获取当前相对位置X|相对位置X继承自：
ih5-base -/- 获取当前相对位置Y|相对位置Y继承自：
ih5-base -/- 获取当前绝对位置X|绝对位置X继承自：
ih5-base -/- 获取当前绝对位置Y|绝对位置Y继承自：
ih5-base -/- 打开本地视频 -/- 关闭本地视频流 -/- 开启获取视频帧 帧率 结束获取视频帧 是否下载 开始记录 -/- 暂停记录 -/- 继续记录 -/- 停止记录 是否下载 清空内存地址 地址 获取设备屏幕 获取媒体设备参数选项
default、 frontCamera、 rearCamera、 none、 获取当前帧动作（回调）表
对应动作 结果引用 结果状态 结果引用属性 结果属性说明 打印为图片 打印的图片 完成 -/- 结束获取视频帧 success fail 当前帧 获取设备屏幕 success fail 视频流 详情 获取媒体设备 success fail 视频流 详情 获取当前帧 success fail 当前帧 详情
若有收获，就点个赞吧
0 人点赞
