<title>AI课件全流程生产接入规范-v1.0</title>
指导原则
业务领域
- 一次需求可以发起多门课程
- 每个课程会拆解出若干个课时(颗粒)或章节
- 每个颗粒可以拆解出若干个节目单
- 每个节目单对应一种表现形式(表演形式)
- 每个表演形式对应的一种或若干种表演方案
- 每个表演方案都有对应的生产线生产
- 每个生产线最终生产的内容主要包含
- 视频
- 可用于2D播放器播放的标准脚本
- 可用于统一播放器播放的3D脚本
- 可用于集成的交互 模块
平台说明
<table><colgroup><col/><col/><col/><col/><col/><col/><col/><col/></colgroup><tbody><tr><td><b>NO</b></td><td><b>平台名称</b></td><td><b>对应环节</b></td><td vertical-align="middle"><b>是否可外部接入</b></td><td><b>链接地址</b></td><td vertical-align="middle"><b>设计师</b></td><td vertical-align="middle"><b>研发负责</b></td><td vertical-align="middle"><b>设计文档</b></td></tr><tr><td>1</td><td>课程生产管理平台</td><td><ol><li seq="1">课程需求提出</li><li>组课包装上架</li></ol></td><td vertical-align="middle">支持:<ol><li seq="1">支持新的表演类型增加</li><li>支持不同类型需求课程</li></ol></td><td></td><td vertical-align="middle">吴梦赢</td><td vertical-align="middle">汪钱贵</td><td vertical-align="middle"></td></tr><tr><td>2</td><td>教材生产专家系统</td><td><ol><li seq="1">获取知识wiki,教学素材(学习目标库)</li><li>教学大纲</li></ol></td><td vertical-align="middle">支持扩展</td><td></td><td vertical-align="middle"></td><td vertical-align="middle"></td><td vertical-align="middle"></td></tr><tr><td>3</td><td>课程微课设计平台</td><td><ol><li seq="1">教学颗粒安排</li><li>教学设计</li></ol></td><td vertical-align="middle">支持扩展:<ol><li seq="1">不同类型课程扩展微课设计</li></ol></td><td></td><td vertical-align="middle"></td><td vertical-align="middle"></td><td vertical-align="middle"></td></tr><tr><td>4</td><td>课件生产线(总控)</td><td><ol><li seq="1">控制每个颗粒生产方案</li><li>发起各子生产线生产</li><li>收集生产结果</li><li>组合完整的颗粒脚本</li></ol></td><td vertical-align="middle">支持扩展:<ol><li seq="1">支持不同类型的生产线接入</li></ol><br/>参见: </td><td></td><td vertical-align="middle"></td><td vertical-align="middle"></td><td vertical-align="middle"></td></tr><tr><td rowspan="8" vertical-align="middle">5</td><td>普通课件生产</td><td rowspan="8" vertical-align="middle">颗粒(节目单)生产</td><td rowspan="8" vertical-align="middle"></td><td></td><td vertical-align="middle"></td><td vertical-align="middle"></td><td vertical-align="middle"></td></tr><tr><td>美术史颗粒生产</td><td></td><td vertical-align="middle"></td><td vertical-align="middle"></td><td vertical-align="middle"></td></tr><tr><td>科普类颗粒生产</td><td></td><td vertical-align="middle"></td><td vertical-align="middle"></td><td vertical-align="middle"></td></tr><tr><td>实验类颗粒生产</td><td></td><td vertical-align="middle"></td><td vertical-align="middle"></td><td vertical-align="middle"></td></tr><tr><td>RPG游戏颗粒生产</td><td></td><td vertical-align="middle"></td><td vertical-align="middle"></td><td vertical-align="middle"></td></tr><tr><td>互动颗粒生产</td><td></td><td vertical-align="middle"></td><td vertical-align="middle"></td><td vertical-align="middle"></td></tr><tr><td><b>其他待接入的表演形式生产线</b></td><td></td><td vertical-align="middle"></td><td vertical-align="middle"></td><td vertical-align="middle"></td></tr><tr><td></td><td></td><td vertical-align="middle"></td><td vertical-align="middle"></td><td vertical-align="middle"></td></tr><tr><td vertical-align="middle">6</td><td vertical-align="middle">课件生产可视化平台</td><td vertical-align="middle"><ol><li seq="1">查看课程生产过程数据</li><li>查看课程状态</li></ol></td><td vertical-align="middle"></td><td vertical-align="middle"></td><td vertical-align="middle"></td><td vertical-align="middle"></td><td vertical-align="middle"></td></tr><tr><td></td><td></td><td></td><td vertical-align="middle"></td><td></td><td vertical-align="middle"></td><td vertical-align="middle"></td><td vertical-align="middle"></td></tr><tr><td></td><td></td><td></td><td vertical-align="middle"></td><td></td><td vertical-align="middle"></td><td vertical-align="middle"></td><td vertical-align="middle"></td></tr></tbody></table>
接入要求
业务要求
<sheet sheet-id="918co9" token="M9gNsneDBhZMi9tMSbHcNTd4nag"></sheet>
技术要求
<sheet sheet-id="atQSHS" token="M9gNsneDBhZMi9tMSbHcNTd4nag"></sheet>
流程规范
<whiteboard token="ZCjzwVK38h3uOrbywo8cZSGindg"></whiteboard>
接入规范
分阶段接入边界
<sheet sheet-id="COMeiK" token="M9gNsneDBhZMi9tMSbHcNTd4nag"></sheet>
颗粒(表演形式)生产
接入形式
- 方式一:提供BOT接入到主流程,
BOT深度不能超过 5 层 - 方式二:提供标准的接口接入流程
- 同步接口要符合I/O的数据规范(见6.1.2, 6.1.3)
- 异步接口要符合异步任务的接口规范
- 要有任务提交的接口,提交 6.1.2. 的数据,返回任务ID
- 要有任务查询接口,根据任务ID,可以查询到返回的内容
输入数据
输入数据:是指外部系统可以从课程中获得的数据
<sheet sheet-id="Hoehml" token="M9gNsneDBhZMi9tMSbHcNTd4nag"></sheet>
**除以上字段外,还可以提供:**
- 课程发起时的需求信息(目标用户之类的)
- 课程关联的生产项目信息
- 项目生产使用的BOT的
Project Key, 项目生产使用的AiGateWay Key信息 - 生产课程推荐的IP角色信息、角色的配音信息
- 其他需要的未提供的可以联系平台方
输出数据
输出数据:是指接入的外部系统,需要返回的数据
<sheet sheet-id="pWFByj" token="M9gNsneDBhZMi9tMSbHcNTd4nag"></sheet>
过程数据上报规范
详细参见: <cite doc-id="GrZZw1g75iYRCNkVdQ0cxwDzncc" file-type="wiki" title="AI课件通用日志上报设计-v1.0" type="doc"></cite>
过程数据上报的参数中 biz_id 使用的就是 6.1.2. 中的 id
异步任务接入规范
遵循 BTS 授权规范,或者固定的 Bearer 头信息
- 创建异步任务
- [POST] /tasks
- BODY
{
"course_id": "COURSE-10001",
"id": "PARTICLE-0001",
"name": "实验颗粒-酸碱中和",
"plot_text": "请根据讲稿生成实验颗粒内容,突出实验现象与步骤说明。",
"origin_materials": [
{
"type": "image",
"name": "实验器材图",
"url": "https://example.com/resource/equipment.png"
}
],
"material_style": "standard-lab",
"language": "zh-CN",
"subject": "化学",
"target_user": "初中学生",
"ratio": "16:9",
"course_name": "酸碱与盐",
"artist": {
"role": "实验老师",
"voice": "女声-温和"
},
"extra_materials": [],
"teaching_content": {
"goal": "理解中和反应的现象与意义",
"steps": ["观察", "记录", "总结"]
},
"experiment_data": {
"scene": "acid-base-neutralization"
},
"extra_data": {}
}
- 返回值:
{
"task_id": ""
}
- 获取任务结果
- [GET] /tasks/{task_id}
- 返回内容:
{
"course_id": "COURSE-10001",
"id": "PARTICLE-0001",
"status": "SUCCEEDED",
"file_url": "https://example.com/output/script.json",
"play_url": "https://example.com/output/play/particle-0001",
"duration": 286,
"message": "ok"
}