mix-public 1.2.0 → 1.2.2

package/docs/api//345/210/206/344/272/253/345/212/237/350/203/275/020-ShareSessionImage.md

@@ -0,0 +1,94 @@
+---
+date: 2026-03-06
+permalink: /pages/api-share-session-image/
+categories: 
+  - API
+  - 分享功能
+tags: []
+author: { name: AI Assistant }
+---
+
+# ShareSessionImage - 分享图片到微信好友
+
+## 功能描述
+
+分享在线图片到微信好友。在非APP环境中会输出控制台日志提示不支持分享功能。
+
+## 调用类型
+
+同步类
+
+## 方法说明
+
+```typescript
+ShareSessionImage(option: { 
+  PicturePath: string; 
+}): void
+```
+
+### 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 | 默认值 |
+|--------|------|------|------|--------|
+| PicturePath | string | 是 | 在线图片路径 | "" |
+
+### 返回值说明
+
+无返回值
+
+## 代码示例
+
+### JavaScript 示例
+
+```javascript
+// 分享在线图片到微信好友
+mixPublicLib.ShareSessionImage({ 
+  PicturePath: "https://example.com/image.jpg"
+});
+```
+
+### TypeScript 示例
+
+```typescript
+import type { SharPicType } from './paramsTypes';
+
+const shareOptions: SharPicType = {
+  PicturePath: "https://example.com/image.jpg"
+};
+
+mixPublicLib.ShareSessionImage(shareOptions);
+```
+
+## 使用说明
+
+### 平台支持
+
+- **APP端**: 调用原生分享功能，将指定的在线图片分享到微信好友
+- **Web端**: 控制台输出提示信息："非APP环境不支持分享功能"
+
+### 参数要求
+
+- **PicturePath**: 必须是有效的在线图片URL
+- 图片URL必须可访问，否则分享可能失败
+- 支持常见的图片格式（jpg、png、gif等）
+
+### 分享效果
+
+- 在微信中以图片形式展示
+- 用户可以直接查看和保存图片
+- 图片质量取决于原图质量和网络状况
+
+## 注意事项
+
+- 此功能仅在APP环境中有效
+- Web端和小程序端不支持此功能，会输出控制台警告
+- 图片URL必须是完整的绝对路径（包含http/https协议）
+- 图片大小不宜过大，建议进行适当的压缩处理
+- 分享内容需要符合微信的内容安全规范
+- 某些特殊域名的图片可能无法正常分享
+
+## 相关 API
+
+- [`ShareSessionUrl`](./019-ShareSessionUrl.md) - 分享链接到微信会话
+- [`ShareTimelineUrl`](./021-ShareTimelineUrl.md) - 分享链接到微信朋友圈
+- [`ShareTimelineImage`](./022-ShareTimelineImage.md) - 分享图片到微信朋友圈

package/docs/api//345/210/206/344/272/253/345/212/237/350/203/275/021-ShareTimelineUrl.md

@@ -0,0 +1,107 @@
+---
+date: 2026-03-06
+permalink: /pages/api-share-timeline-url/
+categories: 
+  - API
+  - 分享功能
+tags: []
+author: { name: AI Assistant }
+---
+
+# ShareTimelineUrl - 分享链接到微信朋友圈
+
+## 功能描述
+
+分享链接到微信朋友圈（以卡片的形式）。在非APP环境中会输出控制台日志提示不支持分享功能。
+
+## 调用类型
+
+同步类
+
+## 方法说明
+
+```typescript
+ShareTimelineUrl(option: { 
+  Title: string; 
+  Detail: string; 
+  Icon: string; 
+  Url: string; 
+}): void
+```
+
+### 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 | 默认值 |
+|--------|------|------|------|--------|
+| Title | string | 是 | 微信链接标题 | "" |
+| Detail | string | 是 | 微信链接详情 | "" |
+| Icon | string | 是 | 微信链接图标 | "" |
+| Url | string | 是 | 链接地址 | "" |
+
+### 返回值说明
+
+无返回值
+
+## 代码示例
+
+### JavaScript 示例
+
+```javascript
+// 分享链接到微信朋友圈
+mixPublicLib.ShareTimelineUrl({ 
+  Title: "精彩内容分享",
+  Detail: "这是一篇非常有价值的文章，推荐给你！",
+  Icon: "https://example.com/icon.png",
+  Url: "https://example.com/article"
+});
+```
+
+### TypeScript 示例
+
+```typescript
+import type { ShareUrlType } from './paramsTypes';
+
+const shareOptions: ShareUrlType = {
+  Title: "精彩内容分享",
+  Detail: "这是一篇非常有价值的文章，推荐给你！",
+  Icon: "https://example.com/icon.png",
+  Url: "https://example.com/article"
+};
+
+mixPublicLib.ShareTimelineUrl(shareOptions);
+```
+
+## 使用说明
+
+### 平台支持
+
+- **APP端**: 调用原生分享功能，以卡片形式分享到微信朋友圈
+- **Web端**: 控制台输出提示信息："非APP环境不支持分享功能"
+
+### 参数要求
+
+- **Title**: 分享卡片的标题，建议简洁明了
+- **Detail**: 分享卡片的描述信息，用于展示内容概要
+- **Icon**: 分享卡片的缩略图，建议使用有效的图片URL
+- **Url**: 要分享的目标链接，必须是有效的URL
+
+### 分享效果
+
+- 在微信朋友圈中以卡片形式展示
+- 用户点击卡片可以跳转到指定URL
+- 图标会显示在卡片左侧或上方（取决于微信版本）
+
+## 注意事项
+
+- 此功能仅在APP环境中有效
+- Web端和小程序端不支持此功能，会输出控制台警告
+- 图标URL必须可访问，否则可能显示默认图标
+- 分享内容需要符合微信的内容安全规范
+- URL参数过长可能会影响分享效果
+- 微信朋友圈对分享频率可能有限制
+
+## 相关 API
+
+- [`ShareSessionUrl`](./019-ShareSessionUrl.md) - 分享链接到微信会话
+- [`ShareSessionImage`](./020-ShareSessionImage.md) - 分享图片到微信会话
+- [`ShareTimelineImage`](./022-ShareTimelineImage.md) - 分享图片到微信朋友圈

package/docs/api//345/210/206/344/272/253/345/212/237/350/203/275/022-ShareTimelineImage.md

@@ -0,0 +1,95 @@
+---
+date: 2026-03-06
+permalink: /pages/api-share-timeline-image/
+categories: 
+  - API
+  - 分享功能
+tags: []
+author: { name: AI Assistant }
+---
+
+# ShareTimelineImage - 分享图片到微信朋友圈
+
+## 功能描述
+
+分享在线图片到微信朋友圈。在非APP环境中会输出控制台日志提示不支持分享功能。
+
+## 调用类型
+
+同步类
+
+## 方法说明
+
+```typescript
+ShareTimelineImage(option: { 
+  PicturePath: string; 
+}): void
+```
+
+### 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 | 默认值 |
+|--------|------|------|------|--------|
+| PicturePath | string | 是 | 在线图片路径 | "" |
+
+### 返回值说明
+
+无返回值
+
+## 代码示例
+
+### JavaScript 示例
+
+```javascript
+// 分享在线图片到微信朋友圈
+mixPublicLib.ShareTimelineImage({ 
+  PicturePath: "https://example.com/image.jpg"
+});
+```
+
+### TypeScript 示例
+
+```typescript
+import type { SharPicType } from './paramsTypes';
+
+const shareOptions: SharPicType = {
+  PicturePath: "https://example.com/image.jpg"
+};
+
+mixPublicLib.ShareTimelineImage(shareOptions);
+```
+
+## 使用说明
+
+### 平台支持
+
+- **APP端**: 调用原生分享功能，将指定的在线图片分享到微信朋友圈
+- **Web端**: 控制台输出提示信息："非APP环境不支持分享功能"
+
+### 参数要求
+
+- **PicturePath**: 必须是有效的在线图片URL
+- 图片URL必须可访问，否则分享可能失败
+- 支持常见的图片格式（jpg、png、gif等）
+
+### 分享效果
+
+- 在微信朋友圈中以图片形式展示
+- 用户可以直接查看和保存图片
+- 图片质量取决于原图质量和网络状况
+
+## 注意事项
+
+- 此功能仅在APP环境中有效
+- Web端和小程序端不支持此功能，会输出控制台警告
+- 图片URL必须是完整的绝对路径（包含http/https协议）
+- 图片大小不宜过大，建议进行适当的压缩处理
+- 分享内容需要符合微信的内容安全规范
+- 微信朋友圈对图片分享频率可能有限制
+- 某些特殊域名的图片可能无法正常分享
+
+## 相关 API
+
+- [`ShareSessionUrl`](./019-ShareSessionUrl.md) - 分享链接到微信会话
+- [`ShareSessionImage`](./020-ShareSessionImage.md) - 分享图片到微信会话
+- [`ShareTimelineUrl`](./021-ShareTimelineUrl.md) - 分享链接到微信朋友圈

package/docs/api//345/210/206/344/272/253/345/212/237/350/203/275/023-Base64ImageShareWechatTimeline.md

@@ -0,0 +1,99 @@
+---
+date: 2026-03-06
+permalink: /pages/api-base64-image-share-wechat-timeline/
+categories: 
+  - API
+  - 分享功能
+tags: []
+author: { name: AI Assistant }
+---
+
+# Base64ImageShareWechatTimeline - 分享Base64图片到朋友圈
+
+## 功能描述
+
+分享base64图片文件到微信朋友圈。在非APP环境中会输出控制台日志提示不支持分享功能。
+
+## 调用类型
+
+同步类
+
+## 方法说明
+
+```typescript
+Base64ImageShareWechatTimeline(option: { 
+  Base64: string; 
+}): void
+```
+
+### 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 | 默认值 |
+|--------|------|------|------|--------|
+| Base64 | string | 是 | 图片base64文件 | "" |
+
+### 返回值说明
+
+无返回值
+
+## 代码示例
+
+### JavaScript 示例
+
+```javascript
+// 分享base64图片到微信朋友圈
+mixPublicLib.Base64ImageShareWechatTimeline({ 
+  Base64: "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8/5+hHgAHggJ/PchI7wAAAABJRU5ErkJggg=="
+});
+```
+
+### TypeScript 示例
+
+```
+import type { SharBase64PicType } from './paramsTypes';
+
+const shareOptions: SharBase64PicType = {
+  Base64: "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8/5+hHgAHggJ/PchI7wAAAABJRU5ErkJggg=="
+};
+
+mixPublicLib.Base64ImageShareWechatTimeline(shareOptions);
+```
+
+## 使用说明
+
+### 平台支持
+
+- **APP端**: 调用原生分享功能，将base64格式的图片分享到微信朋友圈
+- **Web端**: 控制台输出提示信息："非APP环境不支持分享功能"
+
+### 参数要求
+
+- **Base64**: 必须是有效的base64图片数据
+- 支持完整的base64数据URL格式（包含data:image/xxx;base64,前缀）
+- 也支持纯base64字符串（不包含前缀）
+
+### Base64格式
+
+- 完整格式：`data:image/png;base64,iVBORw0KGgoAAAANSUhEUg...`
+- 纯base64：`iVBORw0KGgoAAAANSUhEUg...`
+
+### 分享效果
+
+- 在微信朋友圈中以图片形式展示
+- 用户可以直接查看和保存图片
+- 图片质量取决于原始base64数据的质量
+
+## 注意事项
+
+- 此功能仅在APP环境中有效
+- Web端和小程序端不支持此功能，会输出控制台警告
+- base64数据不宜过大，建议对大图片进行压缩处理
+- 过大的base64数据可能导致分享失败或应用卡顿
+- 分享内容需要符合微信的内容安全规范
+- 微信朋友圈对图片分享频率可能有限制
+- 某些特殊格式的base64数据可能无法正常解析
+
+## 相关 API
+
+- [`Base64ImageShareWechatSession`](./024-Base64ImageShareWechatSession.md) - Base64图片分享到微信会话
+- [`ShareTimelineImage`](./022-ShareTimelineImage.md) - 分享图片到微信朋友圈

package/docs/api//345/210/206/344/272/253/345/212/237/350/203/275/024-Base64ImageShareWechatSession.md

@@ -0,0 +1,98 @@
+---
+date: 2026-03-06
+permalink: /pages/api-base64-image-share-wechat-session/
+categories: 
+  - API
+  - 分享功能
+tags: []
+author: { name: AI Assistant }
+---
+
+# Base64ImageShareWechatSession - 分享Base64图片到微信好友
+
+## 功能描述
+
+分享base64图片文件到微信好友。在非APP环境中会输出控制台日志提示不支持分享功能。
+
+## 调用类型
+
+同步类
+
+## 方法说明
+
+```typescript
+Base64ImageShareWechatSession(option: { 
+  Base64: string; 
+}): void
+```
+
+### 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 | 默认值 |
+|--------|------|------|------|--------|
+| Base64 | string | 是 | 图片base64文件 | "" |
+
+### 返回值说明
+
+无返回值
+
+## 代码示例
+
+### JavaScript 示例
+
+```javascript
+// 分享base64图片到微信好友
+mixPublicLib.Base64ImageShareWechatSession({ 
+  Base64: "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8/5+hHgAHggJ/PchI7wAAAABJRU5ErkJggg=="
+});
+```
+
+### TypeScript 示例
+
+```typescript
+import type { SharBase64PicType } from './paramsTypes';
+
+const shareOptions: SharBase64PicType = {
+  Base64: "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8/5+hHgAHggJ/PchI7wAAAABJRU5ErkJggg=="
+};
+
+mixPublicLib.Base64ImageShareWechatSession(shareOptions);
+```
+
+## 使用说明
+
+### 平台支持
+
+- **APP端**: 调用原生分享功能，将base64格式的图片分享到微信好友
+- **Web端**: 控制台输出提示信息："非APP环境不支持分享功能"
+
+### 参数要求
+
+- **Base64**: 必须是有效的base64图片数据
+- 支持完整的base64数据URL格式（包含data:image/xxx;base64,前缀）
+- 也支持纯base64字符串（不包含前缀）
+
+### Base64格式
+
+- 完整格式：`data:image/png;base64,iVBORw0KGgoAAAANSUhEUg...`
+- 纯base64：`iVBORw0KGgoAAAANSUhEUg...`
+
+### 分享效果
+
+- 在微信中以图片形式展示
+- 用户可以直接查看和保存图片
+- 图片质量取决于原始base64数据的质量
+
+## 注意事项
+
+- 此功能仅在APP环境中有效
+- Web端和小程序端不支持此功能，会输出控制台警告
+- base64数据不宜过大，建议对大图片进行压缩处理
+- 过大的base64数据可能导致分享失败或应用卡顿
+- 分享内容需要符合微信的内容安全规范
+- 某些特殊格式的base64数据可能无法正常解析
+
+## 相关 API
+
+- [`Base64ImageShareWechatTimeline`](./023-Base64ImageShareWechatTimeline.md) - Base64图片分享到微信朋友圈
+- [`ShareSessionImage`](./020-ShareSessionImage.md) - 分享图片到微信会话

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

@@ -0,0 +1,128 @@
+---
+date: 2026-03-06
+permalink: /pages/api-upload-photo/
+categories: 
+  - API
+  - 图片处理
+tags: []
+author: { name: AI Assistant }
+---
+
+# UploadPhoto - 选择图片
+
+## 功能描述
+
+选择图片（唤起相机或相册）。调用相机或相册并返回拍摄或选择的图片文件对象。
+
+## 调用类型
+
+异步返回类
+
+## 方法说明
+
+```typescript
+UploadPhoto(option: { 
+  isCut: boolean; 
+  Quality: number; 
+}): Promise<object>
+```
+
+### 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 | 默认值 |
+|--------|------|------|------|--------|
+| isCut | boolean | 是 | 是否裁剪 | false |
+| Quality | number | 是 | 质量（0-1） | 1 |
+
+### 返回值说明
+
+Promise<object> - 返回拍摄或选择的图片文件对象
+
+## 代码示例
+
+### JavaScript 示例
+
+```javascript
+// 选择图片（不裁剪，最高质量）
+mixPublicLib.UploadPhoto({ 
+  isCut: false, 
+  Quality: 1 
+})
+.then(file => {
+  console.log("选择的图片文件:", file);
+  // 处理图片文件
+})
+.catch(error => {
+  console.error("选择图片失败:", error);
+});
+
+// 选择图片（裁剪，中等质量）
+mixPublicLib.UploadPhoto({ 
+  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.UploadPhoto(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
+
+- [`LibraryPhoto`](./026-LibraryPhoto.md) - 相册选择图片
+- [`CameraPhoto`](./027-CameraPhoto.md) - 相机拍摄图片
+- [`SaveToSd`](./028-SaveToSd.md) - 保存在线图片