57 lines
1.5 KiB
Markdown
57 lines
1.5 KiB
Markdown
# x-base642file-s
|
|
|
|
### 功能介绍
|
|
|
|
将Base64格式的图片数据转换为本地PNG文件，支持跨平台使用。
|
|
|
|
### 兼容性
|
|
|
|
| Harmony | IOS | Android | WEB | 小程序 |
|
|
| --- | --- | --- | --- | --- |
|
|
| 支持 | 支持 | 支持 | 支持 | 支持 |
|
|
|
|
### API文档
|
|
|
|
#### toPngFile
|
|
|
|
`toPngFile(data: string): Promise<string>`
|
|
将Base64格式的图片数据转换为本地PNG文件。
|
|
|
|
**参数说明：**
|
|
- data: Base64格式的图片数据字符串，支持带前缀（如：data:image/png;base64,）或纯Base64字符串
|
|
|
|
**返回值：**
|
|
- `Promise<string>`: 返回生成的PNG文件路径
|
|
- 成功：resolve(文件路径)
|
|
- 失败：reject(空字符串)
|
|
|
|
### 平台差异说明
|
|
|
|
- Android：文件保存在应用的外部缓存目录
|
|
- iOS：文件保存在应用的缓存目录
|
|
- Web：返回Blob URL
|
|
- 小程序：文件保存在小程序用户目录
|
|
|
|
### 使用示例
|
|
|
|
```ts
|
|
|
|
import { toPngFile } from "@/uni_modules/x-base642file-s"
|
|
|
|
// 示例：将Base64图片转换为本地文件
|
|
const convertToFile = async (base64Data: string) => {
|
|
try {
|
|
const filePath = await toPngFile(base64Data)
|
|
console.log('文件保存成功：', filePath)
|
|
} catch (error) {
|
|
console.error('转换失败')
|
|
}
|
|
}
|
|
```
|
|
|
|
### 注意事项
|
|
|
|
1. 使用前，Windows用户需要先在页面引用，打基座，再编译使用
|
|
2. Mac用户可直接引用使用
|
|
3. 建议在处理大量数据时进行适当的性能优化
|
|
4. 生成的文件会保存在各平台对应的缓存目录中，请注意及时清理不需要的文件 |