台球运动的精彩瞬间，是爱好者们渴望留存与分享的珍贵片段。但传统人工录制+剪辑的方式，既费时间精力，又难以精准捕捉每一个高光时刻。现在，自动化的台球直播、分析与剪辑，成为台球行业发展与爱好者们的共同诉求。萤石开放平台提供台球厅精彩瞬间智能识别和自动剪辑服务，通过AI算法实时分析台球比赛，轻松捕捉每一个精彩时刻。

总体流程

萤石开放平台依托成熟的AI算法和丰富的API能力，只需5步即可构建：

详细开发步骤

步骤一：环境准备与平台接入

【1】平台注册与应用创建

• 注册账号：访问萤石开放平台，注册企业级账号

• 创建应用：在开发者中心创建新应用，获取 AppKey 和 AppSecret （AK/SK）

• 开通服务：开通云录制服务、云点播服务、AI算法服务

【2】设备选型与接入

• 设备选择：选择支持云录制能力的萤石/海康设备

• 添加设备：通过设备序列号和验证码，将设备添加到开放平台账号

• 设备状态：确保设备在线且能正常输出视频流

• 网络环境：确保设备网络稳定，带宽满足视频传输需求

【3】配置文件设置

创建 .env 配置文件，填写以下参数：

	# 萤石开放平台配置 BILLIARDS_ACCESS_TOKEN=your_access_token # 设备配置 BILLIARDS_DEVICE_SERIAL=your_device_serial BILLIARDS_CHANNEL_NO=your_channel_no # 存储配置 BILLIARDS_PROJECT_ID=your_project_id BILLIARDS_SPACE_ID=your_space_id BILLIARDS_VOD_SPACE_ID=your_vod_space_id # 录制配置 BILLIARDS_RECORD_DURATION_SECONDS=your_record_duration_seconds # 存储路径 BILLIARDS_STORAGE_BASE_PATH=./storage

步骤二：创建一次性录制计划

【1用

• 接口地址：

https://open.ys7.com/api/service/cloudrecord/video/plan/oneOff

请求方式：POST  

请求头：

 请求参数：

【2】响应处理

• 核心返回字段：

data.planId ：录制计划ID

meta.code ：响应码（200表示成功）

• 注意事项：

计划名称必须使用英文格式

录制时长建议设置为60秒以上

步骤三：文件元数据搜索

【1】接口调用

• 接口地址：

https://ophttps://open.ys7.com/api/service/open/vod/file/listById

请求方式：POST   

请求头：

请求参数：

【2】响应处理

• 核心返回字段：

data.result[0].folderNode ：文件节点

data.result[0].fileName ：文件名

data.result[0].urls ：文件URL列表

• 注意事项：

搜索前需等待60秒，确保录制文件已生成

tagId需使用录制计划ID（interger）

步骤四：视频分析

【1】接口调用

• 接口地址：

https://open.ys7.com/api/service/intelligence/algo/analysis/billiards_video_analysis 

请求方式：POST   

请求头：

请求参数：

【2】响应处理

• 核心返回字段：

data.taskType ：算法类型（billiards_video_analysis）

data.requestId ：请求唯一ID

• 注意事项：

需要开通云信令服务

需要开通AI算法服务reasoning

需要联系客服手动开通该接口调用权限   分析结果通过云信令异步推送

消息类型：ys.open.ai.resultData

【3】异步推送结果格式

• 消息体字段

body.code ：错误码

body.requestId ：请求ID

body.taskType ：任务类型

body.images[0].content_ann.time_period ：时间范围（毫秒）

body.images[0].content_ann.tags ：标签列表

body.images[0].content_ann.labels ：连击数（高级版）

时间范围格式：

[[开始时间戳, 结束时间戳], [开始时间戳, 结束时间戳], ...]

单位：毫秒，视频相对时间

步骤五：视频剪辑

【1】接口调用

• 接口地址：

https://open.ys7.com/api/service/cloudrecord/video/convert

请求方式：POST   

请求头：

请求参数：

【2】响应处理

• 核心返回字段：

data.taskId ：剪辑任务ID

meta.code ：响应码（200表示成功）

• 注意事项：

最终录制文件将输出至云点播产品内   需开通云点播控制台

时间线合并不能超过30个

步骤六：等待剪辑完成并获取文件地址

【1】查询剪辑状态和获取文件地址

• 接口地址：

https://open.ys7.com/api/service/open/cloud/vod/task/files/{taskId}

请求方式：GET 

请求头：

路径参数：

 查询参数：

【2】响应处理

• 核心返回字段：

data[0].folderNode ：文件ID

data[0].fileName ：文件名

data[0].fileUrl ：文件地址

data[0].coverPicUrl ：封面图地址

data[0].startTime ：开始时间  data[0].stopTime ：结束时间  data[0].fileSize ：文件大小

meta.code ：响应码（200表示成功，404表示资源不存在）

• 轮询机制：

-每1秒查询一次剪辑状态；

-最大等待时间：300秒（5分钟）；

-当返回404时表示剪辑任务还未完成，继续轮询  当返回200且包含文件数据时表示剪辑完成；

-计划名称必须使用英文格式；

-录制时长建议设置为60秒以上。

常见问题与解决方案

依托萤石开放平台实现台球场景的智能服务，精准捕捉每一个赛场高光，自动完成视频的智能剪辑，高效留存运动中的精彩时刻。基于萤石开放平台扎实的技术底座，让台球运动的每一个精彩瞬间都被精准定格、妥善留存，用智能科技升级打球体验。

———————————————————————————————————————————

作为全球领先的视觉物联网云平台提供商，萤石的技术实力与服务价值，早已成为行业内的标杆。作为支撑全品类智能联动的“神经中枢”，萤石物联网云平台具备亿级设备接入能力，截至2024年底，平台IoT设备接入数超3亿，其中视频类设备超2.5亿，展现出强大的平台承载力与用户粘性，成为连接设备、用户与场景的核心纽带。 在夯实自身平台能力的基础上，萤石进一步开放技术能力，将物联价值延伸至千行百业。萤石开放平台深度融合AI中台能力，涵盖音视频多媒体、消息通知处理、智能算法调度、视频存储备份、ERTC、大数据、物联接入等，已为智慧连锁、智慧养老、文教娱乐、畜牧养殖等36万余位行业客户提供数智化转型升级支撑；萤石物联专有云支持专有化部署，助力中大型企业和组织的数字化转型升级。