台球运动的精彩瞬间是爱好者们渴望留存与分享的珍贵片段。但传统人工录制剪辑的方式既费时间精力又难以精准捕捉每一个高光时刻。现在自动化的台球直播、分析与剪辑成为台球行业发展与爱好者们的共同诉求。萤石开放平台提供台球厅精彩瞬间智能识别和自动剪辑服务通过AI算法实时分析台球比赛轻松捕捉每一个精彩时刻。总体流程萤石开放平台依托成熟的AI算法和丰富的API能力只需5步即可构建详细开发步骤步骤一环境准备与平台接入【1】平台注册与应用创建注册账号访问萤石开放平台注册企业级账号创建应用在开发者中心创建新应用获取 AppKey 和 AppSecret AK/SK开通服务开通云录制服务、云点播服务、AI算法服务【2】设备选型与接入设备选择选择支持云录制能力的萤石/海康设备添加设备通过设备序列号和验证码将设备添加到开放平台账号设备状态确保设备在线且能正常输出视频流网络环境确保设备网络稳定带宽满足视频传输需求【3】配置文件设置创建 .env 配置文件填写以下参数#萤石开放平台配置BILLIARDS_ACCESS_TOKENyour_access_token#设备配置BILLIARDS_DEVICE_SERIALyour_device_serial BILLIARDS_CHANNEL_NOyour_channel_no#存储配置BILLIARDS_PROJECT_IDyour_project_id BILLIARDS_SPACE_IDyour_space_idBILLIARDS_VOD_SPACE_IDyour_vod_space_id#录制配置BILLIARDS_RECORD_DURATION_SECONDSyour_record_duration_seconds#存储路径BILLIARDS_STORAGE_BASE_PATH./storage步骤二创建一次性录制计划【1用接口地址https://open.ys7.com/api/service/cloudrecord/video/plan/oneOff请求方式POST请求头请求参数【2】响应处理核心返回字段data.planId 录制计划IDmeta.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需使用录制计划IDinterger步骤四视频分析【1】接口调用接口地址https://open.ys7.com/api/service/intelligence/algo/analysis/billiards_video_analysis请求方式POST请求头请求参数【2】响应处理核心返回字段data.taskType 算法类型billiards_video_analysisdata.requestId 请求唯一ID注意事项需要开通云信令服务需要开通AI算法服务reasoning需要联系客服手动开通该接口调用权限 分析结果通过云信令异步推送消息类型ys.open.ai.resultData【3】异步推送结果格式消息体字段body.code 错误码body.requestId 请求IDbody.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 剪辑任务IDmeta.code 响应码200表示成功注意事项最终录制文件将输出至云点播产品内 需开通云点播控制台时间线合并不能超过30个步骤六等待剪辑完成并获取文件地址【1】查询剪辑状态和获取文件地址接口地址https://open.ys7.com/api/service/open/cloud/vod/task/files/{taskId}请求方式GET请求头路径参数查询参数【2】响应处理核心返回字段data[0].folderNode 文件IDdata[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万余位行业客户提供数智化转型升级支撑萤石物联专有云支持专有化部署助力中大型企业和组织的数字化转型升级。