文档反馈
文档反馈

基本结构

云信互动白板中有两层结构。第一层是文档。第二层是页面。

刚进入房间时,房间内有一份默认文档,默认文档内有一块白板。通过上传并添加文档(ppt, pptx, doc, docx, pdf),会在房间内加入文档。在文档内,可以添加,删除页面。

下面假设添加了名为"力学.pdf"的文档。该文档内有3个页面,则其房间内结构应该为:

-- whiteboard (默认文档)
    -- page 1
-- 力学.pdf
    -- page 1
    -- page 2
    -- page 3

添加、删除文档

白板工具栏中提供了文档上传功能,用户可以通过配置工具栏开启该功能。若用户想要自定义工具栏,并使用云信提供的文档转码功能,可以参考文档转码一节。目前云信的文档转码支持ppt, pptx, doc, docx, pdf等文档转图片。ppt转成动态h5正在开发中。

工具栏开启文档上传

ToolCollection.getInstance时,或者通过toolCollection.setContainerOptions函数,可以设置工具栏支持文档上传。

containerOptions: [
    {
        position: 'left',
        items: [
            //其他工具
            {
                tool: 'docUpload'
            }
        ]
    }
]

添加文档

若用户自定义工具栏,可以通过addDoc函数添加文档。目前仅支持文档转图片功能,因此文档实际上是由多个图片组成。

drawPlugin.addDoc({
    docName: '力学',
    params: [
        {
            url: 'https://xxx1.jpg',
            width: 1000,
            height: 1000
        },
        {
            url: 'https://xxx2.jpg',
            width: 1000,
            height: 1000
        }
    ]
})

删除文档

工具栏中docSelect子组件可以删除文档。也可以通过调用deleteBoard删除文档

drawPlugin.deleteBoard('力学')

页面管理

每个文档内有多个页面。工具栏提供了下面的页面控制工具。其中预览窗口内有添加,删除页面的按钮。

items: [
    {
        tool: 'firstPage',
        hint: '第一页'
    },
    {
        tool: 'prevPage',
        hint: '上一页'
    },
    {
        tool: 'pageInfo'
    },
    {
        tool: 'nextPage',
        hint: '下一页'
    },
    {
        tool: 'lastPage',
        hint: '最后一页'
    },
    {
        tool: 'preview',
        hint: '预览',
        previewSliderPosition: 'right'                    
    }
]

若需要自定义工具栏,可以通过下面的接口控制页面:

添加页面

添加页面。默认添加在当前文档的最后一页。若insertAfter为K,则新添加文档位于第K份文档之后

drawPlugin.addPage(insertAfter?: number)

删除页面

删除指定页面。

drawPlugin.deletePage(index: number)

切换页面

跳转到指定页面。

drawPlugin.gotoPage(index: number)
drawPlugin.gotoPrevPage()
drawPlugin.gotoNextPage()
drawPlugin.gotoFirstPage()
drawPlugin.gotoNextPage()
×

反馈成功

非常感谢您的反馈,我们会继续努力做得更好。