基础配置 ​

options配置 ​

功能板块配置 (主要用于按钮的隐藏展示) ​

介绍 ​

在创建PPT的过程中，可根据自己的业务场景需要某个功能不需要进行展示的时候，可以调用此参数进行实现。

功能提示

该参数的配置具有父子级对应关系，如果开启了生成方式(2003)，那么AI智能生成和导入本地都会进行开启。
如果只开启其中一项配置功能，例如导入word(2006)那么他将会自动向上查找导入本地大纲(2005)和生成方式(2003)，但是不会主动开启其他配置项。
具体的接收值可以为布尔值、数组、以逗号隔开的场景值字符串。
假设：
不传递的情况下，则默认全部开启。 布尔值：传递true则代表全部开启，传递false则代表全部关闭。
数组： [2006,2007] 代表只开启导入word和导入xmind， [2024] 代表只开启PPT编辑器。
具体可参考下述场景值参考

场景值参考 ​

使用方式 ​

ts
 AipptIframe.show({
    options: { 
      // fc_plate: "2001,2002",
      // fc_plate: [2001, 2002],
      fc_plate: true // 全部开启直接传入true即可
    }, 
  })

下载配置 ​

介绍 ​

在创建PPT的过程中，根据自己的业务场景需要增加一些自由下载配置。

功能提示

具体的接收值只允许为number的0,1,2。
不传递的情况下，则默认是PPT内部进行下载，且发送一个下载成功之后的一个OSS链接。
该OSS链接时效为5分钟
0:只发送消息通知，但不会进行自动下载，包含可下载地址(具体可查看事件通知"PPT_DOWNLOAD" | "OUTLINE_DOWNLOAD")
1:直接进行下载，但是不会发送消息通知
2:直接进行下载，并且发送消息通知，包含可下载地址(具体可查看事件通知"PPT_DOWNLOAD" | "OUTLINE_DOWNLOAD")

使用方式 ​

ts
 AipptIframe.show({
    options: { 
      // download_mode: 0 // 只发送消息通知，但不会进行自动下载，包含可下载地址
      // download_mode: 1 // 直接进行下载，但是不会发送消息通知
      download_mode: 2  // 直接进行下载，并且发送消息通知，包含可下载地址
    }, 
  })

场景鉴权配置 ​

介绍 ​

在创建PPT的过程中，根据自己的业务场景需要增加一些验证权限，可增加该配置。

功能提示

具体的接收值可以为布尔值、数组、以逗号隔开的场景值字符串。
不传递的情况下，则默认全部不需要进行鉴权
布尔值：传递true则代表全部需要进行鉴权，传递false则代表全部不需要进行鉴权。
数组： [1001,1002] 代表只开启输入生成和预置词生成需要进行验证权限。
字符串: 1001,1002 代表只开启输入生成和预置词生成需要进行验证权限。
具体可参考下述场景值参考

方法 ​

场景值参考 ​

使用方式 ​

ts
 AipptIframe.show({
    options: { 
      // scene_auth: "1001,1002",
      // scene_auth: [1001, 1002],
      scene_auth: false, // 默认值
    }, 
    onMessage(type,data){  
      if (type === 'SCENE_AUTH') { // 鉴权功能验证
        if (data.scene === 1021) { // 点击换个大纲 不允许进行下一步
           AipptIframe.sceneAuthContinue(false); 
        } else {
          AipptIframe.sceneAuthContinue(true); // 可继续执行下一步
        } 
      } 
    }
  })

自定义导入功能 ​

在创建PPT的过程中，根据自己的业务场景可增加自由传递关键词或者文件跳转至自动生成大纲页面。

参数 ​

异常处理 ​

在初始化自定义导入的情况下会存在异常处理，用户可根据下列的错误进行排查。

使用方式 ​

ts
try {
     await AipptIframe.show({
        appkey: appkey,
        channel: channel,
        code: code,
        editorModel: editorModel,
        container: container,
        container: 'body',
        options: {
          custom_generate: {
            content: "标题",
            type: 1
          }
        }
      })
  } catch (e) {  // 进行异常描述的信息捕获
    console.log(e, 'catch exception')
  }

routerOptions配置 ​

介绍 ​

目前AIPPT版本有三个页面：

  1. 作品列表页面
  2. AI任务生成页面
  3. 编辑器页面

可根据自己的需求进行配置自己需要的界面， 其中作品列表页面、AI任务生成页面必须存在一个，如果缺失，则不会进行创建Iframe页面。

配置项 ​

使用说明 ​

默认配置 ​
ts
try {
  await AipptIframe.show({
    routerOptions: {
      list: ['workspace', 'generate', 'editor'],
    }
  })
} catch (e) {  // 进行异常描述的信息捕获
  console.log(e, 'catch exception')
}
配置作品列表页面 ​
ts
try {
  await AipptIframe.show({
    routerOptions: {
      list: ['workspace'],
    }
  })
} catch (e) {  // 进行异常描述的信息捕获
  console.log(e, 'catch exception')
}
配置AI任务生成页面 ​
ts
try {
  await AipptIframe.show({
    routerOptions: {
      list: ['generate'],
    }
  })
} catch (e) {  // 进行异常描述的信息捕获
  console.log(e, 'catch exception')
}
配置作品列表页面 + 编辑PPT页面 ​
ts
try {
  await AipptIframe.show({
    routerOptions: {
      list: ['workspace', 'editor'],
    }
  })
} catch (e) {  // 进行异常描述的信息捕获
  console.log(e, 'catch exception')
}
配置AI任务生成页面 + 编辑PPT页面 ​
ts
try {
  await AipptIframe.show({
    routerOptions: {
      list: ['generate', 'editor'],
    }
  })
} catch (e) {  // 进行异常描述的信息捕获
  console.log(e, 'catch exception')
}
直接进入编辑PPT页面 ​
ts
try {
  await AipptIframe.show({
    routerOptions: {
      list: ['workspace', 'generate', 'editor'],
      // 存在editor 并且存在id的情况下 则直接跳转至编辑器页面
      editor: {
        id: 1
      }
    }
  })
} catch (e) {  // 进行异常描述的信息捕获
  console.log(e, 'catch exception')
}
模板场景配置 ​
ts
try {
  await AipptIframe.show({
    routerOptions: {
      list: ['workspace', 'generate', 'editor'],
      // 存在generate 并且存在templateScene的情况下 则进入选择模板页面时会自动选择字段并筛选 不存在则为全部模板
      generate: {
        templateScene: 1
      }
    }
  })
} catch (e) {  // 进行异常描述的信息捕获
  console.log(e, 'catch exception')
}
自定义生成页流程节点 (主要针对自定义导入功能使用) ​

特别说明：目前只支持自定义导入功能中的粘贴Markdown

ts
try {
  await AipptIframe.show({
    routerOptions: {
      list: ['workspace', 'generate', 'editor'],
      // 存在generate 并且 并且存在step !== 1的情况下
      generate: {
        step: 2, 默认为1
      }
    }
  })
} catch (e) {  // 进行异常描述的信息捕获
  console.log(e, 'catch exception')
}

异常处理 ​