事件机制 #

// 获取 JSSDK 实例对象
const instance = WebOfficeSDK.init({
  officeType: WebOfficeSDK.OfficeType.Writer,
  appId: 'xxxxx',
  fileId: 'xxxxx'
})

await instance.ready()

const handle = res => console.log(res)

// 监听事件
instance.ApiEvent.AddApiEventListener('tabSwitch', handle)

// 取消监听
instance.ApiEvent.RemoveApiEventListener('tabSwitch', handle)

instance.ApiEvent.AddApiEventListener('fileOpen', data => {
  console.log('fileOpen: ', data)
})

{
  duration: 812,
  fileInfo: {
    createTime: 1606461829,
    id: "94749723688",
    modifyTime: 1606461829,
    name: "userName",
    officeType: "s",
  },
  stageTime: 1614,
  success: true,
  time: 1614,
  ts: 1607858260164,
}

{
  msg: "Fail",
  result: "Fail"
}

instance.ApiEvent.AddApiEventListener('error', data => {
  console.log('error: ', data)
})

{
  reason: 'Fail'
}

instance.ApiEvent.AddApiEventListener('tabSwitch', data => {
  console.log('tabSwitch: ', data)
})

// 以 Excel 为例：
{
  tabKey: "InsertTab",
  tabKey: "StartTab",
  // ……更多状态看具体 tab
}

instance.ApiEvent.AddApiEventListener('DocumentSaveStatus', data => {
  console.log('DocumentSaveStatus: ', data)
})

{
  status: 0, // 文档无更新
  status: 1, // 版本保存成功, 触发场景：手动保存、定时保存、关闭网页
  status: 2, // 暂不支持保存空文件, 触发场景：内核保存完后文件为空
  status: 3, // 空间已满
  status: 4, // 保存中请勿频繁操作，触发场景：服务端处理保存队列已满，正在排队
  status: 5, // 保存失败
  status: 6, // 文件更新保存中，触发场景：修改文档内容触发的保存
  status: 7, // 保存成功，触发场景：文档内容修改保存成功
}

instance.ApiEvent.AddApiEventListener('previewLimit', data => {
  console.log('previewLimit: ', data)
})

// 文字
// 由于文字文档是流式排版，无法获取准确的真实页数，因此回调只有 total 一个参数
{
  total: 4 // 限制页数
}
// PPT 以及 PDF
{
  total: 4 // 限制页数
  realTotal: 10 // 真实总页数
}

instance.ApiEvent.AddApiEventListener('hasDocMap', data => {
  console.log('hasDocMap: ', data)
})

instance.ApiEvent.AddApiEventListener('fullscreenchange', data => {
  console.log('fullscreenchange: ', data)
})

{
  status: 0, // 退出全屏
  status: 1, // 进入全屏
}

instance.ApiEvent.AddApiEventListener('webSocketStatus', data => {
  console.log('webSocketStatus: ', data)
})

{
  status: '_online', // 已连接
  status: '_offline', // 已离线
  status: '_close', // 关闭连接
}

instance.ApiEvent.AddApiEventListener('fileNameChange', data => {
  console.log('fileNameChange: ', data)
})

{
  fileName: 'NewWebOffice'
}

instance.ApiEvent.AddApiEventListener('filePasswordStatus', data => {
  console.log('filePasswordStatus: ', data)
})

{
  status: 'NeedPassword', // 需要输入密码
  status: 'InvalidPassword', // 密码验证错误
}

instance.ApiEvent.AddApiEventListener('ModelVisible', data => {
  console.log('ModelVisible: ', data)
})

instance.ApiEvent.AddApiEventListener('OnBroadcast', data => {
  console.log('OnBroadcast: ', data)
})

instance.ApiEvent.AddApiEventListener('ClipboardCopy', data => {
  console.log('ClipboardCopy: ', data)
})

instance.ApiEvent.AddApiEventListener('Worksheet_Activate', data => {
  console.log('Worksheet_Activate: ', data)
})

instance.ApiEvent.AddApiEventListener('SlideShowBegin', data => {
  console.log('SlideShowBegin: ', data)
})

instance.ApiEvent.AddApiEventListener('CurrentPageChange', data => {
  console.log('CurrentPageChange: ', data)
})