AiPPT 接入文档
产品特色
﻿
﻿
﻿
﻿
●AiPPT 是一款智能生成演示幻灯片的在线工具。用户无需花费太多时间在无意义的格式设置上，输入标题即可轻松生成完整的PPT文档。同时 AiPPT 支持导入文案一键生成 PPT，让 PPT 创作更加高效。
●AiPPT 聚焦于内容，确保每张幻灯片都以清晰的主题和关键信息为核心，简洁明了地表达您的观点。提供丰富多样的模板和布局样式，以灵活适应不同内容的需要。支持一键切换模板和配色方案，让您的 PPT 瞬间焕然一新。
●AI 智能匹配内容，确保幻灯片的一致性和专业外观，既节省时间，又不失设计品质。不再为设计而烦恼，让您更专注于演示内容的准备与展示。
﻿
产品功能
一键生成
输入标题即可直接生成 PPT
文档导入
支持 docx、xmind、freemind、markdown 文件导入直接生成 PPT
思维导图
支持思维导图在线预览、编辑、下载为文本或图片格式
在线编辑
支持 PPT 在线进行文本、图片、表格、图表、主题、模板编辑与整套模板替换
在线演示
支持 PPT 作品的在线演示
PPT下载
支持将在线作品保存到本地, 可选格式包含: PPT、PDF、PNG、JPEG
﻿
接入流程
申请接入
联系 AiPPT 获取用于对接的 App Key 和 Secret Key﻿
能力集成
选择UI版或API版接入, 集成过程中请确保准确配置 App ID
上线发布
通过查看集成过程中相关数据的测试, 在确保产品正确集成 SDK 后可以上线发布
﻿
方式一: UI版接入
概述
﻿
UI 版接入用于将 AiPPT 能力以 iframe 形式集成到PC端浏览器中，并提供了一套完整的视图，其最大化的保留了 AiPPT PC站(https://aippt.cn)的功能与设计
﻿
 
业务流程
﻿﻿
接入步骤
1.获取授权
参考文档获取初始化所需的 Code, 文档移步: https://alidocs.dingtalk.com/i/p/4oJRz08llpgzLZMyJRz0r88xQv61nmLZ﻿
﻿
2.JS SDK 接入
I.引入 UMD
在html head中添加jssdk url路径
9
<!-- 引入js 建议您在加载js文件的时候增加一个时间戳，避免js缓存，导致最新功能无法使用 -->
<script src="https://aippt-domestic.aippt.com/static/js/aippt-iframe-sdk.js"></script>

<script>
  // 打印出信息表示成功
  console.log(AipptIframe) 
</script>

II.初始化 SDK
AipptIframe.show(options)
26
// 该方法在拿到服务端返回的授权code后调用。创建一个iframe，并挂载到指定元素或body上。
// 返回值 Promise<void>
try {
  await AipptIframe.show({
  appkey: '645e1231d1ba5',
  channel: 'xxx',
  code: '429738a59f91d6977843fd1c893bc66b',
  editorModel: true,
  scene_auth: false
  container: document.getElementById('#wrap'),
  onMessage(eventType,data){
    console.log(eventType,data)
  }
})
} catch (e) {
  /*
    如果初始化code信息失效，请在此处捕捉错误信息
    e: {
      code: number
      data: null
      msg: string | "code已过期"
    }
  */

}
III.参数说明
参数
说明
类型
是否必传
默认值
appkey
授权参数appkey
﻿string﻿
是
-
channel
授权参数
﻿string﻿
与API策略一致
-
code
授权参数
﻿string﻿
是
-
editorModel
是否可编辑
﻿boolean﻿
否
false
options
可选配置项(https://alidocs.dingtalk.com/i/p/4oJRz08llpgzLZMyJRz0rg6qQjpOAmLZ)
﻿object﻿
否
-
container
iframe挂载的目标DOM元素,如不传默认挂载到Body
﻿HTMLElement﻿
否
document.body
onMessage
iframe用户交互事件监听(参考https://alidocs.dingtalk.com/i/p/4oJRz08llpgzLZMyJRz0rg6qQjpOAmLZ)(事件通知选项)
﻿Function﻿
否
-
﻿
方式二: API 2.0 版接入
概述
﻿
通过接入服务端 API 的方式接入 AiPPT 产品, 对比接入UI版的接入方式，API 版可实现流程与样式的高度定制。
﻿
﻿
名词解释
名词
描述
示例
大纲
仅包含标题的文本
6
# 飞机结构介绍        
## 1. 飞机结构概述        
### 1.1 飞机结构的定义     
#### 1.1.1 飞机结构的基本概念
... ...
内容
包含标题和正文的文本
7
# 飞机结构介绍
## 1. 飞机结构概述
### 1.1 飞机结构的定义
#### 1.1.1 飞机结构的基本概念
- 飞机结构是指构成飞机的各种部件和组件，它们共同承担飞行过程中的力和载荷。
... ...
﻿
接入步骤
1.获取授权
授权步骤
获取调用 API 所需的 Token 
参考文档移步: https://alidocs.dingtalk.com/i/p/4oJRz08llpgzLZMyJRz0r88xQv61nmLZ﻿
﻿
2.能力接入
参考文档移步: https://alidocs.dingtalk.com/i/p/4oJRz08llpgzLZMyJRz0rq67oWavYmLZ﻿
﻿
方式三: API 1.0 版接入
概述
﻿
通过接入服务端与前端 API 的方式接入 AiPPT 产品, 对比接入UI版的接入方式，API 版可实现流程与样式的高度定制。
﻿
﻿
名词解释
名词
描述
示例
大纲
仅包含标题的文本
6
# 飞机结构介绍        
## 1. 飞机结构概述        
### 1.1 飞机结构的定义     
#### 1.1.1 飞机结构的基本概念
... ...
内容
包含标题和正文的文本
7
# 飞机结构介绍
## 1. 飞机结构概述
### 1.1 飞机结构的定义
#### 1.1.1 飞机结构的基本概念
- 飞机结构是指构成飞机的各种部件和组件，它们共同承担飞行过程中的力和载荷。
... ...
大纲数据
描述: 
通过大纲和内容生成的 JSON 数据。
数据来源：
1.‘标题生成大纲’与‘大纲生成内容’的接口数据
2.Markdown 内容的文件
数据使用:
使用 JSSDK generateOutline 导出 outlineJSON 生成PPT
25
{
    "type": "title",
    "depth": 1,
    "id": 1,
    "parentId": 0,
    "value": "实现财富自由的路径",
    "children": [
    {
    "type": "catalog",
    "value": "目录",
    "depth": 2,
    "children": [
    {
    "type": "title",
    "value": "1. 财富自由概述",
    "depth": 3,
    "children": [],
    "parentId": 2,
    "id": 3,
    "sort": 0,
    "direction": 1,
    "expanded": true
    },
... ...
﻿
接入步骤
1.获取授权
授权步骤
1.获取调用 API 所需的 Token 
2.获取调用 SDK 所需的 Code
参考文档移步: https://alidocs.dingtalk.com/i/p/4oJRz08llpgzLZMyJRz0r88xQv61nmLZ﻿
﻿
2. JS SDK 接入
I.引入 UMD
在html head中添加jssdk url路径
9
<!-- 引入js -->
<script src="https://aippt-domestic.aippt.com/static/js/aippt-jssdk.js"></script>

<script>
  // 打印出信息表示成功
  console.log(AipptJsapiSDK) 
</script>

II.初始化 SDK
6
const aipptJsapi = await AipptJsapiSDK.init({
	appkey: 'Your Appkey',
	channel: 'Your Channel',
	code: 'Your Code',
});
﻿
3. 能力接入
参考文档移步: https://alidocs.dingtalk.com/i/p/4oJRz08llpgzLZMyJRz0r0P2gMpyAmLZ﻿
﻿