uniapp 实现预览 Base64 编码字符串的文档

2024-06-30  本文已影响0人  小北风sky

此需求为

h5 端请求接口得到包含 PDF 文件数据的 Base64 编码字符串

希望可以预览 PDF 文件,并且可以保存和分享

关于 Base64 编码
Base64 是一种用 64 个字符来表示任意二进制数据的方法。当你有一个 PDF 文件并希望在网络上
发送或在 JavaScript 中处理时,你可以将其转换为 Base64 字符串。这样做的好处是,Base64
字符串只包含 ASCII 字符,因此可以在任何地方使用,不会出现编码问题。

实现思路

h5 通过 js 和原生交互,将 Base64 编码字符串传递给原生,因为 uniap 未提供可以直接访问 base64 编码字符串的方法,所以原生需通过将编码信息写入原生新创建的 pdf 文件,再通过 uniapp 提供的 **uni.openDocument(OBJECT)** 方法,新开页面打开文档

思路概述

uniapp 下将 base64 编码信息写入原生新创建的 pdf 文件,总结起来需要下面五个步骤

  1. 需要请求本地文件系统对象
  2. 创建或打开当前目录下指定的文件
  3. 获取文件关联的写文件操作对象 FileWriter
  4. 将数据写入文件
  5. 通过 uni.openDocument 打开文件

uniap api 缺陷

uni-app js 引擎版还不支持用 uni.getFileSystemManager() 获取全局唯一的文件管理器 ,可部分替代的方案是plus.io

编码实现

明确下 plus 下私有目录的作用

应用私有资源目录,对应常量 plus.io.PRIVATE_WWW,仅应用自身可读

应用私有文档目录,对应常量 plus.io.PRIVATE_DOC,仅应用自身可读写

所以应该使用 plus.io.PRIVATE_DOC 路径

具体实现的代码如下

plus.io.requestFileSystem(plus.io.PRIVATE_DOC, function(fs) {
    console.log(fs.root.fullPath)
    const filePath = `$ {fs.root.fullPath}files/${Date.now()}.pdf`
    fs.root.getFile(filePath, {
        create: true
    }, function(fileEntry) {
        console.log('filePath' + filePath)
        fileEntry.createWriter(function(writer) {
            writer.onwrite = function() {
                console.log('success filePath' + filePath)
                uni.openDocument({
                    filePath: filePath,
                    showMenu: true,
                    success: () = > {
                        uni.hideLoading()
                    },
                    fail: (error) = > {
                        uni.hideLoading()
                        toast(error.message || '操作失败,请稍后再试')
                    }
                })
            }
            writer.onerror = function(e) {
                uni.hideLoading()
                console.log('写入文件失败:' + e.message)
            }
            writer.writeAsBinary(base64)
        }, function(e) {
            uni.hideLoading()
            console.log('创建文件写入对象失败:' + e.message)
        })
    }, function(e) {
        uni.hideLoading()
        console.log('获取文件失败:' + e.message)
    })
}, function(e) {
    uni.hideLoading()
    console.log('请求文件系统失败:' + e.message)
})

其中 writer.writeAsBinary(base64) 接受一个二进制字符串,注意 base64 串无需 URI 前缀 data:application/pdf;base64,

fs.root.fullPath 为获取应用的沙盒路径

错误方案

在调研时,采用过 writer.write()write 方法接受一个 ArrayBufferBlob 对象

// 将 base64 数据转换为 ArrayBuffer 数据
let arrayBuffer = uni.base64ToArrayBuffer(base64Data);

...
writer.write(arrayBuffer)

但上述操作会出错,无法正确的写入数据,未进行深入的研究,放弃使用此方法

上一篇下一篇

猜你喜欢

热点阅读