mix-public 1.2.0 → 1.2.2

package/docs/api//345/205/266/344/273/226/345/212/237/350/203/275/080-UnbindCloudChannel.md

@@ -0,0 +1,134 @@
+---
+date: 2026-03-06
+permalink: /pages/api-unbind-cloud-channel/
+categories: 
+  - API
+  - 推送通知
+tags: []
+author: { name: AI Assistant }
+---
+
+# UnbindCloudChannel - 解绑云通道
+
+## 功能描述
+
+解绑设备的云推送通道。用于注销设备，停止接收云端推送消息。
+
+## 调用类型
+
+同步类
+
+## 方法说明
+
+```typescript
+UnbindCloudChannel(): void
+```
+
+### 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 | 默认值 |
+|--------|------|------|------|--------|
+| 无 | 无 | 否 | 无参数 | 无 |
+
+### 返回值说明
+
+无返回值
+
+## 代码示例
+
+### JavaScript 示例
+
+```javascript
+// 解绑云通道
+mixPublicLib.UnbindCloudChannel();
+
+// 在用户退出登录时解绑云通道
+function onUserLogout() {
+  mixPublicLib.UnbindCloudChannel();
+  console.log("云通道已解绑，将不再接收推送消息");
+}
+
+// 在应用设置中提供解绑选项
+document.getElementById('unbindPushBtn').addEventListener('click', () => {
+  if (confirm("确定要关闭推送通知吗？")) {
+    mixPublicLib.UnbindCloudChannel();
+    alert("推送通知已关闭");
+  }
+});
+```
+
+### TypeScript 示例
+
+```typescript
+// 解绑云通道
+mixPublicLib.UnbindCloudChannel();
+
+// 带错误处理的解绑操作
+try {
+  mixPublicLib.UnbindCloudChannel();
+  console.log("云通道解绑成功");
+} catch (error) {
+  console.error("云通道解绑失败:", error);
+}
+```
+
+## 使用说明
+
+### 功能说明
+
+- 注销设备从云端推送服务
+- 删除设备的推送令牌（token）
+- 断开与推送服务器的连接通道
+- 停止设备接收远程推送消息
+
+### 平台差异
+
+- **iOS**: 解绑APNs（Apple Push Notification service）
+- **Android**: 解绑FCM（Firebase Cloud Messaging）或其他推送服务
+- **Web端**: 可能不支持或提供模拟功能
+
+### 解绑流程
+
+1. 向云端服务器发送解绑请求
+2. 删除本地存储的推送令牌
+3. 断开推送通道连接
+4. 停止接收新的推送消息
+
+### 使用场景
+
+- 用户退出登录时的设备解绑
+- 用户主动关闭推送通知
+- 应用卸载前的清理操作
+- 设备更换时的旧设备解绑
+- 隐私保护相关的推送禁用
+
+## 注意事项
+
+- **权限状态**: 
+  - 解绑后需要重新调用 `BindCloudChannel` 才能恢复推送
+  - 解绑不会影响系统的推送权限设置
+  - 用户仍可以在系统设置中管理推送权限
+- **平台限制**: 
+  - Web端通常不支持原生推送通道解绑
+  - 老版本操作系统可能有兼容性问题
+  - 某些推送服务可能有解绑延迟
+- **用户体验**: 
+  - 解绑操作通常是后台进行的
+  - 用户可能不会立即停止接收推送
+  - 建议在解绑后提供明确的状态提示
+- **最佳实践**: 
+  - 在用户退出登录时自动解绑
+  - 提供手动解绑的用户选项
+  - 结合推送设置页面使用
+  - 测试解绑后的实际效果
+- **安全性**: 
+  - 确保解绑请求的安全传输
+  - 避免在解绑过程中泄露敏感信息
+  - 遵守相关的隐私和安全规范
+
+## 相关 API
+
+- [`BindCloudChannel`](./079-BindCloudChannel.md) - 绑定云通道
+- [`GetApnsAuthorizationStatus`](./064-GetApnsAuthorizationStatus.md) - 获取推送授权状态
+- [`SettingApns`](./068-SettingApns.md) - 推送设置
+- [`IsOpenPushSound`](./078-IsOpenPushSound.md) - 是否开启推送声音

package/docs/api//345/205/266/344/273/226/345/212/237/350/203/275/092-PhoneCall.md

@@ -0,0 +1,131 @@
+---
+date: 2026-03-06
+permalink: /pages/api-phone-call/
+categories: 
+  - API
+  - 系统功能
+tags: []
+author: { name: AI Assistant }
+---
+
+# PhoneCall - 拨打电话
+
+## 功能描述
+
+拨打电话。用于直接拨打指定的电话号码。
+
+## 调用类型
+
+同步类
+
+## 方法说明
+
+```typescript
+PhoneCall(option: { 
+  phoneNumber: string; 
+}): void
+```
+
+### 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 | 默认值 |
+|--------|------|------|------|--------|
+| phoneNumber | string | 是 | 电话号码 | "" |
+
+### 返回值说明
+
+无返回值
+
+## 代码示例
+
+### JavaScript 示例
+
+```javascript
+// 拨打客服电话
+mixPublicLib.PhoneCall({ 
+  phoneNumber: "400-123-4567" 
+});
+
+// 拨打紧急电话
+mixPublicLib.PhoneCall({ 
+  phoneNumber: "110" 
+});
+
+// 从用户输入获取电话号码
+const userInput = document.getElementById('phoneInput').value;
+if (validatePhoneNumber(userInput)) {
+  mixPublicLib.PhoneCall({ phoneNumber: userInput });
+}
+
+// 在联系人页面拨打电话
+function callContact(phoneNumber) {
+  if (confirm(`确定要拨打 ${phoneNumber} 吗？`)) {
+    mixPublicLib.PhoneCall({ phoneNumber });
+  }
+}
+```
+
+### TypeScript 示例
+
+```typescript
+import type { PhoneCallType } from './paramsTypes';
+
+// 拨打电话
+const callOptions: PhoneCallType = {
+  phoneNumber: "400-123-4567"
+};
+mixPublicLib.PhoneCall(callOptions);
+```
+
+## 使用说明
+
+### 电话号码格式
+
+- **国际格式**: +86-138-0000-0000
+- **国内格式**: 138-0000-0000 或 400-123-4567
+- **紧急号码**: 110, 119, 120 等
+- **特殊号码**: 支持分机号、特殊服务号码等
+
+### 平台差异
+
+- **APP端**: 直接调用系统拨号应用
+- **Web端**: 可能使用tel:协议或提供模拟功能
+- **小程序**: 调用小程序的拨号API
+
+### 使用场景
+
+- 客服热线拨打
+- 紧急联系电话
+- 商家联系电话
+- 个人联系人拨号
+- 预约确认电话
+
+## 注意事项
+
+- **权限要求**: 
+  - APP端需要CALL_PHONE权限
+  - Web端需要用户交互触发（如点击事件）
+  - 某些平台可能需要用户确认拨号操作
+- **用户体验**: 
+  - 建议在拨号前进行用户确认
+  - 提供电话号码的验证和格式化
+  - 考虑国际化的电话号码格式
+- **最佳实践**: 
+  - 验证电话号码的有效性
+  - 处理特殊字符和格式
+  - 提供拨号失败的错误处理
+  - 测试不同地区的电话号码格式
+- **兼容性**: 
+  - 不同平台的拨号行为可能不同
+  - 某些设备可能不支持直接拨号
+  - Web端的tel:协议支持程度因浏览器而异
+- **安全性**: 
+  - 避免拨打未知或恶意电话号码
+  - 对用户输入的电话号码进行安全验证
+  - 遵守相关的隐私和安全规范
+
+## 相关 API
+
+- [`GetDeviceInfo`](./058-GetDeviceInfo.md) - 获取设备信息
+- [`ShowDialog`](./088-ShowDialog.md) - 弹出对话框
+- [`Shock`](./081-Shock.md) - 震动反馈

package/docs/api//345/205/266/344/273/226/345/212/237/350/203/275/094-FullScreen.md

@@ -0,0 +1,87 @@
+---
+date: 2026-03-06
+permalink: /pages/api-full-screen/
+categories: 
+  - API
+  - 页面控制
+tags: []
+author: { name: AI Assistant }
+---
+
+# FullScreen - 全屏显示
+
+## 功能描述
+
+关闭IOS底部安全区域
+
+## 调用类型
+
+同步类
+
+## 方法说明
+
+```typescript
+FullScreen(): void
+```
+
+### 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 | 默认值 |
+|--------|------|------|------|--------|
+| 无 | 无 | 否 | 无参数 | 无 |
+
+### 返回值说明
+
+无返回值
+
+## 代码示例
+
+### JavaScript 示例
+
+```javascript
+// 关闭IOS底部安全区域
+mixPublicLib.FullScreen();
+
+```
+
+### TypeScript 示例
+
+```typescript
+import type { FullScreenType } from './paramsTypes';
+
+// 全屏整个页面
+mixPublicLib.FullScreen();
+```
+
+## 使用说明
+
+### 全屏模式
+
+- **页面全屏**: IOS默认会有底部安全区域高度，调用此方法关闭IOS底部安全区域（IOS独有）
+
+### 平台差异
+
+- **APP端**: 调用原生全屏API，可能隐藏底部安全区域
+
+### 使用场景
+
+- 视频播放器的全屏模式
+- 游戏的沉浸式体验
+- 图片或画廊的全屏查看
+- 演示文稿的全屏展示
+- 任何需要最大化显示区域的场景
+
+## 注意事项
+
+- **最佳实践**: 
+  - 在适当的时机进入全屏（如用户点击全屏按钮）
+  - 监听全屏状态变化事件
+  - 提供优雅的全屏退出处理
+  - 测试不同浏览器和设备的兼容性
+
+## 相关 API
+
+- [`SetTitle`](./050-SetTitle.md) - 设置页面标题
+- [`SetStatusBarBgColor`](./052-SetStatusBarBgColor.md) - 设置状态栏背景色
+- [`GetDeviceInfo`](./058-GetDeviceInfo.md) - 获取设备信息
+- [`GoBack`](./008-GoBack.md) - 返回页面

package/docs/api//345/205/266/344/273/226/345/212/237/350/203/275/104-OnlineService.md

@@ -0,0 +1,128 @@
+---
+date: 2026-03-06
+permalink: /pages/api-online-service/
+categories: 
+  - API
+  - 客服功能
+tags: []
+author: { name: AI Assistant }
+---
+
+# OnlineService - 在线客服
+
+## 功能描述
+
+打开在线客服窗口。用于提供用户与客服人员的实时沟通功能。
+
+## 调用类型
+
+同步类
+
+## 方法说明
+
+```typescript
+OnlineService(option: { 
+  Url: string; 
+}): void
+```
+
+### 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 | 默认值 |
+|--------|------|------|------|--------|
+| Url | string | 是 | 客服系统URL地址 | "" |
+
+### 返回值说明
+
+无返回值
+
+## 代码示例
+
+### JavaScript 示例
+
+```javascript
+// 打开在线客服
+mixPublicLib.OnlineService({ 
+  Url: "https://kefu.example.com/chat" 
+});
+
+// 从配置中获取客服URL
+const config = getAppConfig();
+if (config.Url) {
+  mixPublicLib.OnlineService({ 
+    Url: config.Url 
+  });
+}
+
+// 在帮助页面打开客服
+document.getElementById('contactSupportBtn').addEventListener('click', () => {
+  mixPublicLib.OnlineService({ 
+    Url: "https://kefu.example.com/chat?user_id=" + getCurrentUserId()
+  });
+});
+```
+
+### TypeScript 示例
+
+```typescript
+import type { OnlineServiceType } from './paramsTypes';
+
+// 打开在线客服
+const serviceOptions: OnlineServiceType = {
+  Url: "https://kefu.example.com/chat"
+};
+mixPublicLib.OnlineService(serviceOptions);
+```
+
+## 使用说明
+
+### 客服URL要求
+
+- **完整URL**: 必须包含协议（http/https）
+- **有效域名**: URL必须可访问且有效
+- **参数支持**: 可以包含查询参数传递用户信息
+- **HTTPS推荐**: 建议使用HTTPS以确保安全性
+
+### 平台差异
+
+- **APP端**: 在应用内打开WebView或调用原生客服SDK
+- **Web端**: 在新窗口或iframe中打开客服页面
+- **小程序**: 使用小程序的webview组件打开客服页面
+
+### 使用场景
+
+- 用户遇到问题时的求助入口
+- 产品咨询和售前服务
+- 投诉和建议反馈
+- 技术支持和故障排除
+- 订单相关问题咨询
+
+## 注意事项
+
+- **网络要求**: 
+  - 需要有效的网络连接
+  - 客服URL必须可访问
+  - 某些网络环境可能阻止客服页面加载
+- **用户体验**: 
+  - 客服窗口应该易于关闭
+  - 提供客服工作时间提示
+  - 考虑离线状态下的客服入口处理
+- **最佳实践**: 
+  - 在应用的关键位置提供客服入口
+  - 传递用户上下文信息到客服系统
+  - 测试不同网络环境下的客服连接
+  - 提供客服联系方式的备选方案
+- **兼容性**: 
+  - 不同平台的客服窗口实现可能不同
+  - 某些设备可能限制WebView功能
+  - 老版本系统可能有兼容性问题
+- **安全性**: 
+  - 客服URL应该来自可信源
+  - 避免在URL中传递敏感信息
+  - 遵守相关的隐私和安全规范
+
+## 相关 API
+
+- [`GetDeviceInfo`](./058-GetDeviceInfo.md) - 获取设备信息
+- [`IsNet`](./062-IsNet.md) - 检测网络状态
+- [`ShowDialog`](./088-ShowDialog.md) - 弹出对话框

package/docs/api//345/205/266/344/273/226/345/212/237/350/203/275/107-CutWord.md

@@ -0,0 +1,136 @@
+---
+date: 2026-03-06
+permalink: /pages/api-cut-word/
+categories: 
+  - API
+  - 文本处理
+tags: []
+author: { name: AI Assistant }
+---
+
+# CutWord - 文本分词
+
+## 功能描述
+
+对输入文本进行智能分词处理。用于将连续的文本分割成有意义的词语单元。
+
+## 调用类型
+
+同步类
+
+## 方法说明
+
+```typescript
+CutWord(option: { 
+  KeyWord: string; 
+}): Array<string>
+```
+
+### 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 | 默认值 |
+|--------|------|------|------|--------|
+| KeyWord | string | 是 | 需要分词的文本内容 | "" |
+
+### 返回值说明
+
+Array<string> - 返回分词结果数组，每个元素为一个词语
+
+## 代码示例
+
+### JavaScript 示例
+
+```javascript
+// 对中文文本进行分词
+const result = mixPublicLib.CutWord({ 
+  KeyWord: "今天天气很好，适合出去玩" 
+});
+console.log("分词结果:", result);
+// 输出: ["今天", "天气", "很", "好", "，", "适合", "出去", "玩"]
+
+// 对英文文本进行分词
+const englishResult = mixPublicLib.CutWord({ 
+  KeyWord: "Hello world, this is a test" 
+});
+console.log("英文分词结果:", englishResult);
+// 输出: ["Hello", "world", ",", "this", "is", "a", "test"]
+
+// 处理用户输入的搜索关键词
+function processSearchQuery(query) {
+  const keywords = mixPublicLib.CutWord({ KeyWord: query });
+  return keywords.filter(word => word.length > 1); // 过滤单字符
+}
+```
+
+### TypeScript 示例
+
+```typescript
+import type { CutWordType } from './paramsTypes';
+
+const options: CutWordType = {
+  KeyWord: "人工智能技术发展迅速"
+};
+
+const result: Array<string> = mixPublicLib.CutWord(options);
+console.log("分词结果:", result);
+```
+
+## 使用说明
+
+### 分词特性
+
+- **中文分词**: 支持中文词语的智能识别和分割
+- **英文分词**: 按空格和标点符号进行分割
+- **混合文本**: 支持中英文混合文本的分词
+- **标点处理**: 保留标点符号作为独立的分词单元
+
+### 算法说明
+
+- 基于词典的最大匹配算法
+- 支持新词发现和自定义词典
+- 能够处理歧义和未登录词
+- 优化了常见领域词汇的识别
+
+### 平台差异
+
+- **APP端**: 调用原生NLP引擎进行分词
+- **Web端**: 使用JavaScript分词库或提供模拟功能
+- **小程序**: 可能使用云端分词服务
+
+### 使用场景
+
+- 搜索引擎的关键词提取
+- 文本分析和情感分析
+- 内容标签自动生成
+- 用户输入的语义理解
+- 自然语言处理应用
+
+## 注意事项
+
+- **性能考虑**: 
+  - 长文本分词可能需要较长时间
+  - 建议对大文本进行分段处理
+  - 避免在UI线程中处理大量文本
+- **准确性**: 
+  - 分词结果可能因上下文而异
+  - 专业术语可能需要自定义词典
+  - 某些歧义情况可能无法完全准确处理
+- **最佳实践**: 
+  - 对分词结果进行后处理（如过滤停用词）
+  - 结合具体的业务场景优化分词策略
+  - 测试不同类型的文本分词效果
+  - 考虑多语言支持的需求
+- **兼容性**: 
+  - 不同平台的分词算法可能略有差异
+  - 某些特殊字符可能影响分词效果
+  - 老版本系统可能使用较简单的分词算法
+- **资源消耗**: 
+  - 分词过程会消耗CPU和内存资源
+  - 大量并发分词请求可能影响性能
+  - 建议合理控制分词频率
+
+## 相关 API
+
+- [`GetDeviceInfo`](./058-GetDeviceInfo.md) - 获取设备信息
+- [`ShowMsg`](./087-ShowMsg.md) - 显示消息提示
+- [`OCRIdCard`](./047-OCRIdCard.md) - 身份证OCR

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

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