mix-public 1.2.0 → 1.2.2

package/docs/api//345/233/276/347/211/207/345/244/204/347/220/206/026-LibraryPhoto.md

@@ -0,0 +1,129 @@
+---
+date: 2026-03-06
+permalink: /pages/api-library-photo/
+categories: 
+  - API
+  - 图片处理
+tags: []
+author: { name: AI Assistant }
+---
+
+# LibraryPhoto - 相册选择图片
+
+## 功能描述
+
+相册选择图片。调用相册并返回选择的图片文件对象。
+
+## 调用类型
+
+异步返回类
+
+## 方法说明
+
+```typescript
+LibraryPhoto(option: { 
+  isCut: boolean; 
+  Quality: number; 
+}): Promise<object>
+```
+
+### 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 | 默认值 |
+|--------|------|------|------|--------|
+| isCut | boolean | 是 | 是否裁剪 | false |
+| Quality | number | 是 | 质量（0-1） | 1 |
+
+### 返回值说明
+
+Promise<object> - 返回选择的图片文件对象
+
+## 代码示例
+
+### JavaScript 示例
+
+```javascript
+// 从相册选择图片（不裁剪，最高质量）
+mixPublicLib.LibraryPhoto({ 
+  isCut: false, 
+  Quality: 1 
+})
+.then(file => {
+  console.log("选择的图片文件:", file);
+  // 处理图片文件
+})
+.catch(error => {
+  console.error("选择图片失败:", error);
+});
+
+// 从相册选择图片（裁剪，中等质量）
+mixPublicLib.LibraryPhoto({ 
+  isCut: true, 
+  Quality: 0.7 
+})
+.then(file => {
+  console.log("裁剪后的图片文件:", file);
+})
+.catch(error => {
+  console.error("选择图片失败:", error);
+});
+```
+
+### TypeScript 示例
+
+``typescript
+import type { SelectPhotoType } from './paramsTypes';
+
+const options: SelectPhotoType = {
+  isCut: false,
+  Quality: 1
+};
+
+mixPublicLib.LibraryPhoto(options)
+  .then((file: object) => {
+    console.log("选择的图片文件:", file);
+    // 处理图片文件
+  })
+  .catch((error: any) => {
+    console.error("选择图片失败:", error);
+  });
+```
+
+## 使用说明
+
+### 平台差异
+
+- **Web端**: 调用文件选择器，仅能从本地文件系统选择图片
+- **APP端**: 唤起系统相册，可以从设备相册中选择图片
+
+### 参数说明
+
+- **isCut**: 
+  - `true`: 启用图片裁剪功能
+  - `false`: 不进行裁剪，直接返回原图
+- **Quality**: 
+  - 取值范围：0-1
+  - 1表示最高质量，0表示最低质量
+  - 质量值会影响最终图片的文件大小和清晰度
+
+### 返回值处理
+
+- 返回的Promise解析后得到图片文件对象
+- 文件对象可以用于上传、显示或其他处理
+- Web端返回的是File对象，APP端返回的是经过格式化处理的文件对象
+
+## 注意事项
+
+- 需要用户授权相册权限（APP端）
+- Web端受浏览器安全策略限制，只能选择本地文件
+- 裁剪功能在不同平台的实现可能略有差异
+- 高质量图片可能导致文件过大，影响上传性能
+- 建议根据实际需求调整Quality参数以平衡质量和性能
+- 错误处理很重要，用户可能取消选择操作
+- 此方法仅从相册选择，不支持拍照功能
+
+## 相关 API
+
+- [`UploadPhoto`](./025-UploadPhoto.md) - 选择图片（相机或相册）
+- [`CameraPhoto`](./027-CameraPhoto.md) - 相机拍摄图片
+- [`SaveToSd`](./028-SaveToSd.md) - 保存在线图片

package/docs/api//345/233/276/347/211/207/345/244/204/347/220/206/027-CameraPhoto.md

@@ -0,0 +1,129 @@
+---
+date: 2026-03-06
+permalink: /pages/api-camera-photo/
+categories: 
+  - API
+  - 图片处理
+tags: []
+author: { name: AI Assistant }
+---
+
+# CameraPhoto - 相机拍摄图片
+
+## 功能描述
+
+相机拍摄图片。调用相机拍照并返回拍摄的图片文件对象。
+
+## 调用类型
+
+异步返回类
+
+## 方法说明
+
+```typescript
+CameraPhoto(option: { 
+  isCut: boolean; 
+  Quality: number; 
+}): Promise<object>
+```
+
+### 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 | 默认值 |
+|--------|------|------|------|--------|
+| isCut | boolean | 是 | 是否裁剪 | false |
+| Quality | number | 是 | 质量（0-1） | 1 |
+
+### 返回值说明
+
+Promise<object> - 返回拍摄的图片文件对象
+
+## 代码示例
+
+### JavaScript 示例
+
+```javascript
+// 拍摄图片（不裁剪，最高质量）
+mixPublicLib.CameraPhoto({ 
+  isCut: false, 
+  Quality: 1 
+})
+.then(file => {
+  console.log("拍摄的图片文件:", file);
+  // 处理图片文件
+})
+.catch(error => {
+  console.error("拍摄图片失败:", error);
+});
+
+// 拍摄图片（裁剪，中等质量）
+mixPublicLib.CameraPhoto({ 
+  isCut: true, 
+  Quality: 0.7 
+})
+.then(file => {
+  console.log("裁剪后的图片文件:", file);
+})
+.catch(error => {
+  console.error("拍摄图片失败:", error);
+});
+```
+
+### TypeScript 示例
+
+``typescript
+import type { SelectPhotoType } from './paramsTypes';
+
+const options: SelectPhotoType = {
+  isCut: false,
+  Quality: 1
+};
+
+mixPublicLib.CameraPhoto(options)
+  .then((file: object) => {
+    console.log("拍摄的图片文件:", file);
+    // 处理图片文件
+  })
+  .catch((error: any) => {
+    console.error("拍摄图片失败:", error);
+  });
+```
+
+## 使用说明
+
+### 平台差异
+
+- **Web端**: 调用浏览器的摄像头功能进行拍照
+- **APP端**: 唤起系统相机应用进行拍照
+
+### 参数说明
+
+- **isCut**: 
+  - `true`: 启用图片裁剪功能
+  - `false`: 不进行裁剪，直接返回原图
+- **Quality**: 
+  - 取值范围：0-1
+  - 1表示最高质量，0表示最低质量
+  - 质量值会影响最终图片的文件大小和清晰度
+
+### 返回值处理
+
+- 返回的Promise解析后得到图片文件对象
+- 文件对象可以用于上传、显示或其他处理
+- Web端返回的是File对象，APP端返回的是经过格式化处理的文件对象
+
+## 注意事项
+
+- 需要用户授权相机权限（Web端和APP端都需要）
+- Web端需要HTTPS环境才能访问摄像头（部分浏览器限制）
+- 裁剪功能在不同平台的实现可能略有差异
+- 高质量图片可能导致文件过大，影响上传性能
+- 建议根据实际需求调整Quality参数以平衡质量和性能
+- 错误处理很重要，用户可能取消拍摄操作
+- 此方法仅支持拍照，不支持从相册选择图片
+
+## 相关 API
+
+- [`UploadPhoto`](./025-UploadPhoto.md) - 选择图片（相机或相册）
+- [`LibraryPhoto`](./026-LibraryPhoto.md) - 相册选择图片
+- [`SaveToSd`](./028-SaveToSd.md) - 保存在线图片

package/docs/api//345/233/276/347/211/207/345/244/204/347/220/206/028-SaveToSd.md

@@ -0,0 +1,94 @@
+---
+date: 2026-03-06
+permalink: /pages/api-save-to-sd/
+categories: 
+  - API
+  - 图片处理
+tags: []
+author: { name: AI Assistant }
+---
+
+# SaveToSd - 保存在线图片
+
+## 功能描述
+
+保存在线图片至相册。将指定的在线图片URL保存到设备相册中。
+
+## 调用类型
+
+同步类
+
+## 方法说明
+
+```typescript
+SaveToSd(option: { 
+  PicPath: string; 
+}): void
+```
+
+### 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 | 默认值 |
+|--------|------|------|------|--------|
+| PicPath | string | 是 | 在线图片路径 | "" |
+
+### 返回值说明
+
+无返回值
+
+## 代码示例
+
+### JavaScript 示例
+
+```javascript
+// 保存在线图片到相册
+mixPublicLib.SaveToSd({ 
+  PicPath: "https://example.com/image.jpg"
+});
+```
+
+### TypeScript 示例
+
+```typescript
+import type { SavePicType } from './paramsTypes';
+
+const options: SavePicType = {
+  PicPath: "https://example.com/image.jpg"
+};
+
+mixPublicLib.SaveToSd(options);
+```
+
+## 使用说明
+
+### 平台差异
+
+- **Web端**: 调用saveOnlineImage方法，触发浏览器下载功能
+- **APP端**: 调用原生方法将图片保存到设备相册
+
+### 参数要求
+
+- **PicPath**: 必须是有效的在线图片URL
+- URL必须包含http/https协议
+- 图片必须可访问且格式支持（jpg、png、gif等）
+
+### 保存流程
+
+- Web端会触发浏览器的文件下载对话框
+- APP端会直接保存到系统相册，可能需要用户授权存储权限
+
+## 注意事项
+
+- 需要用户授权存储权限（APP端）
+- Web端受浏览器安全策略限制，可能无法直接保存到相册
+- 图片URL必须有效且可访问
+- 大图片可能需要较长时间保存
+- 某些特殊域名的图片可能因CORS限制无法保存（Web端）
+- 建议在调用前验证图片URL的有效性
+- 保存成功与否通常没有回调通知，需要用户自行确认
+
+## 相关 API
+
+- [`SaveBase64ImageToSd`](./029-SaveBase64ImageToSd.md) - 保存base64图片
+- [`UploadPhoto`](./025-UploadPhoto.md) - 选择图片
+- [`LibraryPhoto`](./026-LibraryPhoto.md) - 相册选择图片

package/docs/api//345/233/276/347/211/207/345/244/204/347/220/206/029-SaveBase64ImageToSd.md

@@ -0,0 +1,99 @@
+---
+date: 2026-03-06
+permalink: /pages/api-save-base64-image-to-sd/
+categories: 
+  - API
+  - 图片处理
+tags: []
+author: { name: AI Assistant }
+---
+
+# SaveBase64ImageToSd - 保存Base64图片
+
+## 功能描述
+
+保存base64图片至相册。将base64格式的图片数据保存到设备相册中。
+
+## 调用类型
+
+同步类
+
+## 方法说明
+
+```typescript
+SaveBase64ImageToSd(option: { 
+  Base64: string; 
+}): void
+```
+
+### 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 | 默认值 |
+|--------|------|------|------|--------|
+| Base64 | string | 是 | 图片base64文件 | "" |
+
+### 返回值说明
+
+无返回值
+
+## 代码示例
+
+### JavaScript 示例
+
+```javascript
+// 保存base64图片到相册
+mixPublicLib.SaveBase64ImageToSd({ 
+  Base64: "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8/5+hHgAHggJ/PchI7wAAAABJRU5ErkJggg=="
+});
+```
+
+### TypeScript 示例
+
+```
+import type { SharBase64PicType } from './paramsTypes';
+
+const options: SharBase64PicType = {
+  Base64: "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8/5+hHgAHggJ/PchI7wAAAABJRU5ErkJggg=="
+};
+
+mixPublicLib.SaveBase64ImageToSd(options);
+```
+
+## 使用说明
+
+### 平台差异
+
+- **Web端**: 调用savebase64Image方法，触发浏览器下载功能
+- **APP端**: 调用原生方法将base64图片数据保存到设备相册
+
+### 参数要求
+
+- **Base64**: 必须是有效的base64图片数据
+- 支持完整的base64数据URL格式（包含data:image/xxx;base64,前缀）
+- 也支持纯base64字符串（不包含前缀）
+
+### Base64格式
+
+- 完整格式：`data:image/png;base64,iVBORw0KGgoAAAANSUhEUg...`
+- 纯base64：`iVBORw0KGgoAAAANSUhEUg...`
+
+### 保存流程
+
+- Web端会触发浏览器的文件下载对话框
+- APP端会直接保存到系统相册，可能需要用户授权存储权限
+
+## 注意事项
+
+- 需要用户授权存储权限（APP端）
+- Web端受浏览器安全策略限制，可能无法直接保存到相册
+- base64数据不宜过大，建议对大图片进行压缩处理
+- 过大的base64数据可能导致保存失败或应用卡顿
+- 某些特殊格式的base64数据可能无法正常解析
+- 建议在调用前验证base64数据的有效性
+- 保存成功与否通常没有回调通知，需要用户自行确认
+
+## 相关 API
+
+- [`SaveToSd`](./028-SaveToSd.md) - 保存在线图片
+- [`Base64ImageShareWechatSession`](./024-Base64ImageShareWechatSession.md) - 分享base64图片到微信好友
+- [`Base64ImageShareWechatTimeline`](./023-Base64ImageShareWechatTimeline.md) - 分享base64图片到微信朋友圈

package/docs/api//345/233/276/347/211/207/345/244/204/347/220/206/030-CachePicture.md

@@ -0,0 +1,115 @@
+---
+date: 2026-03-06
+permalink: /pages/api-cache-picture/
+categories: 
+  - API
+  - 图片处理
+tags: []
+author: { name: AI Assistant }
+---
+
+# CachePicture - 图片缓存
+
+## 功能描述
+
+图片缓存，已缓存的图片不再进行网络请求。用于优化图片加载性能，避免重复下载。
+
+## 调用类型
+
+同步类
+
+## 方法说明
+
+```typescript
+CachePicture(option: { 
+  PicUrl: string; 
+  Domid: string; 
+}): string
+```
+
+### 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 | 默认值 |
+|--------|------|------|------|--------|
+| PicUrl | string | 是 | 图片路径 | "" |
+| Domid | string | 是 | 元素ID | "" |
+
+### 返回值说明
+
+string - 返回缓存处理后的结果（Web端返回空字符串）
+
+## 代码示例
+
+### JavaScript 示例
+
+```javascript
+// 图片缓存使用示例
+const result = mixPublicLib.CachePicture({ 
+  PicUrl: "https://example.com/image.jpg",
+  Domid: "cachePic"
+});
+console.log("缓存结果:", result);
+
+// 在HTML中使用
+// <img id="cachePic" src="https://example.com/image.jpg" />
+```
+
+### TypeScript 示例
+
+```typescript
+import type { CachePictureType } from './paramsTypes';
+
+const options: CachePictureType = {
+  PicUrl: "https://example.com/image.jpg",
+  Domid: "cachePic"
+};
+
+const result = mixPublicLib.CachePicture(options);
+console.log("缓存结果:", result);
+```
+
+## 使用说明
+
+### 使用方式
+
+- 该方法通常在图片元素的src属性中直接调用
+- Domid参数对应HTML中img元素的id属性
+- PicUrl参数指定要缓存的图片URL
+
+### HTML集成示例
+
+```html
+<!-- 推荐的使用方式 -->
+<img id="cachePic" src="mixPublicLib.CachePicture({ PicUrl: '图片路径', Domid: 'cachePic' })" />
+
+<!-- 或者通过JavaScript调用 -->
+<img id="cachePic" src="https://example.com/image.jpg" />
+<script>
+  mixPublicLib.CachePicture({ PicUrl: 'https://example.com/image.jpg', Domid: 'cachePic' });
+</script>
+```
+
+### 平台差异
+
+- **Web端**: 调用cachPictureForWeb方法，实现浏览器端的图片缓存
+- **APP端**: 调用原生缓存方法，返回图片URL
+
+### 缓存机制
+
+- 首次加载时会下载并缓存图片
+- 后续相同URL的图片会从缓存中读取
+- 减少网络请求，提升页面加载速度
+
+## 注意事项
+
+- Domid必须与HTML中img元素的id属性一致
+- 图片URL必须有效且可访问
+- Web端和APP端的缓存实现机制不同
+- 缓存的图片可能会占用存储空间
+- 建议对大图片或不常用的图片设置合理的缓存策略
+- 缓存的有效期和清理策略由平台决定
+
+## 相关 API
+
+- [`SaveToSd`](./028-SaveToSd.md) - 保存在线图片
+- [`UploadPhoto`](./025-UploadPhoto.md) - 选择图片

package/docs/api//345/233/276/347/211/207/345/244/204/347/220/206/031-PhotoBrowser.md

@@ -0,0 +1,122 @@
+---
+date: 2026-03-06
+permalink: /pages/api-photo-browser/
+categories: 
+  - API
+  - 图片处理
+tags: []
+author: { name: AI Assistant }
+---
+
+# PhotoBrowser - 图片预览
+
+## 功能描述
+
+放大预览图片，支持多张图片浏览。Web端无此方法，仅在APP端有效。
+
+## 调用类型
+
+同步类
+
+## 方法说明
+
+```typescript
+PhotoBrowser(option: { 
+  Index: number; 
+  ImageList: Array<string>; 
+}): void
+```
+
+### 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 | 默认值 |
+|--------|------|------|------|--------|
+| Index | number | 是 | 预览图片下标 | 0 |
+| ImageList | Array<string> | 是 | 图片列表 | [] |
+
+### 返回值说明
+
+无返回值
+
+## 代码示例
+
+### JavaScript 示例
+
+```javascript
+// 预览多张图片（从第一张开始）
+mixPublicLib.PhotoBrowser({ 
+  Index: 0, 
+  ImageList: [
+    "https://example.com/image1.jpg",
+    "https://example.com/image2.jpg", 
+    "https://example.com/image3.jpg"
+  ]
+});
+
+// 预览多张图片（从第二张开始）
+mixPublicLib.PhotoBrowser({ 
+  Index: 1, 
+  ImageList: [
+    "https://example.com/image1.jpg",
+    "https://example.com/image2.jpg"
+  ]
+});
+```
+
+### TypeScript 示例
+
+```typescript
+import type { PhotoBrowserType } from './paramsTypes';
+
+const options: PhotoBrowserType = {
+  Index: 0,
+  ImageList: [
+    "https://example.com/image1.jpg",
+    "https://example.com/image2.jpg",
+    "https://example.com/image3.jpg"
+  ]
+};
+
+mixPublicLib.PhotoBrowser(options);
+```
+
+## 使用说明
+
+### 平台支持
+
+- **APP端**: 调用原生图片浏览器，支持多张图片的放大、缩小、滑动切换
+- **Web端**: 控制台输出提示信息："图片预览"，无实际功能
+
+### 参数说明
+
+- **Index**: 
+  - 指定初始显示的图片在ImageList中的索引位置
+  - 从0开始计数
+  - 必须小于ImageList的长度
+- **ImageList**: 
+  - 包含所有要预览的图片URL数组
+  - 每个URL必须是有效的在线图片地址
+  - 支持常见的图片格式（jpg、png、gif等）
+
+### 功能特性
+
+- 支持图片放大和缩小
+- 支持左右滑动切换图片
+- 支持双击放大
+- 显示当前图片序号（如：1/3）
+
+## 注意事项
+
+- 此功能仅在APP环境中有效
+- Web端调用此方法不会产生错误，但无实际效果
+- 图片URL必须有效且可访问
+- 建议对大图片进行适当的压缩处理
+- 图片列表不宜过长，建议控制在合理范围内（如20张以内）
+- 某些特殊域名的图片可能因权限限制无法正常预览
+- 用户可以通过手势操作关闭图片预览
+
+## 相关 API
+
+- [`CachePicture`](./030-CachePicture.md) - 图片缓存
+- [`SaveToSd`](./028-SaveToSd.md) - 保存在线图片
+- [`UploadPhoto`](./025-UploadPhoto.md) - 选择图片