mix-public 1.2.0 → 1.2.2

package/docs/api//345/272/224/347/224/250/347/256/241/347/220/206/036-ShowRewardedVideo.md

@@ -0,0 +1,86 @@
+---
+date: 2026-03-06
+permalink: /pages/api-show-rewarded-video/
+categories: 
+  - API
+  - 广告功能
+tags: []
+author: { name: AI Assistant }
+---
+
+# ShowRewardedVideo - 激励广告
+
+## 功能描述
+
+调用时弹出激励广告。用于在APP中展示激励视频广告。
+
+## 调用类型
+
+同步类
+
+## 方法说明
+
+```typescript
+ShowRewardedVideo(): void
+```
+
+### 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 | 默认值 |
+|--------|------|------|------|--------|
+| 无 | 无 | 否 | 无参数 | 无 |
+
+### 返回值说明
+
+无返回值
+
+## 代码示例
+
+### JavaScript 示例
+
+```javascript
+// 显示激励视频广告
+mixPublicLib.ShowRewardedVideo();
+```
+
+### TypeScript 示例
+
+```typescript
+// 显示激励视频广告
+mixPublicLib.ShowRewardedVideo();
+```
+
+## 使用说明
+
+### 平台支持
+
+- **APP端**: 调用原生广告SDK，弹出激励视频广告
+- **Web端**: 控制台输出提示信息："弹出激励广告"
+
+### 广告类型
+
+- **激励视频广告**: 用户观看完整视频后可获得奖励
+- 通常用于游戏、工具类应用的变现
+- 广告内容由广告平台提供
+
+### 使用场景
+
+- 用户完成特定任务后观看广告获取奖励
+- 应用内购买的免费替代方案
+- 增加用户参与度和应用收入
+
+## 注意事项
+
+- 此功能仅在APP环境中有效
+- Web端调用此方法不会产生实际效果
+- 需要在OMEGA项目中配置广告相关参数
+- 广告展示需要网络连接
+- 广告内容由第三方广告平台控制
+- 建议在合适的时机展示广告，避免影响用户体验
+- 某些地区可能对广告内容有特殊限制
+- 广告展示频率应符合平台政策
+
+## 相关 API
+
+- [`ShowInterstitial`](./037-ShowInterstitial.md) - 插屏广告
+- [`Goto`](./001-Goto.md) - 跳转页面

package/docs/api//345/272/224/347/224/250/347/256/241/347/220/206/037-ShowInterstitial.md

@@ -0,0 +1,88 @@
+---
+date: 2026-03-06
+permalink: /pages/api-show-interstitial/
+categories: 
+  - API
+  - 广告功能
+tags: []
+author: { name: AI Assistant }
+---
+
+# ShowInterstitial - 插屏广告
+
+## 功能描述
+
+调用时弹出插屏广告。用于在APP中展示全屏插屏广告。
+
+## 调用类型
+
+同步类
+
+## 方法说明
+
+```typescript
+ShowInterstitial(): void
+```
+
+### 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 | 默认值 |
+|--------|------|------|------|--------|
+| 无 | 无 | 否 | 无参数 | 无 |
+
+### 返回值说明
+
+无返回值
+
+## 代码示例
+
+### JavaScript 示例
+
+```javascript
+// 显示插屏广告
+mixPublicLib.ShowInterstitial();
+```
+
+### TypeScript 示例
+
+```typescript
+// 显示插屏广告
+mixPublicLib.ShowInterstitial();
+```
+
+## 使用说明
+
+### 平台支持
+
+- **APP端**: 调用原生广告SDK，弹出全屏插屏广告
+- **Web端**: 控制台输出提示信息："弹出插屏广告"
+
+### 广告类型
+
+- **插屏广告**: 全屏显示的广告，通常在页面切换或任务完成时展示
+- 广告内容由广告平台提供
+- 用户可以选择关闭广告
+
+### 使用场景
+
+- 页面切换之间的广告展示
+- 游戏关卡完成后的广告
+- 应用内重要操作完成后的广告
+- 增加应用收入的变现方式
+
+## 注意事项
+
+- 此功能仅在APP环境中有效
+- Web端调用此方法不会产生实际效果
+- 需要在OMEGA项目中配置广告相关参数
+- 广告展示需要网络连接
+- 广告内容由第三方广告平台控制
+- 建议在合适的时机展示广告，避免影响用户体验
+- 某些地区可能对广告内容有特殊限制
+- 广告展示频率应符合平台政策
+- 插屏广告通常有关闭按钮，用户可以选择跳过
+
+## 相关 API
+
+- [`ShowRewardedVideo`](./036-ShowRewardedVideo.md) - 激励广告
+- [`Goto`](./001-Goto.md) - 跳转页面

package/docs/api//345/272/224/347/224/250/347/256/241/347/220/206/056-SetBadgeValue.md

@@ -0,0 +1,115 @@
+---
+date: 2026-03-06
+permalink: /pages/api-set-badge-value/
+categories: 
+  - API
+  - 应用控制
+tags: []
+author: { name: AI Assistant }
+---
+
+# SetBadgeValue - 设置应用角标
+
+## 功能描述
+
+设置应用图标右上角的数字角标。用于显示未读消息数量或其他通知计数。
+
+## 调用类型
+
+同步类
+
+## 方法说明
+
+```typescript
+SetBadgeValue(option: { 
+  BadgeValue: number; 
+}): void
+```
+
+### 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 | 默认值 |
+|--------|------|------|------|--------|
+| BadgeValue | number | 是 | 角标数值（0表示清除角标） | 0 |
+
+### 返回值说明
+
+无返回值
+
+## 代码示例
+
+### JavaScript 示例
+
+```javascript
+// 设置应用角标为5
+mixPublicLib.SetBadgeValue({ 
+  BadgeValue: 5 
+});
+
+// 清除应用角标
+mixPublicLib.SetBadgeValue({ 
+  BadgeValue: 0 
+});
+
+// 动态更新角标
+let unreadCount = 10;
+mixPublicLib.SetBadgeValue({ 
+  BadgeValue: unreadCount 
+});
+```
+
+### TypeScript 示例
+
+```typescript
+import type { SetBadgeValueType } from './paramsTypes';
+
+// 设置角标
+const badgeOptions: SetBadgeValueType = {
+  BadgeValue: 5
+};
+mixPublicLib.SetBadgeValue(badgeOptions);
+
+// 清除角标
+const clearOptions: SetBadgeValueType = {
+  BadgeValue: 0
+};
+mixPublicLib.SetBadgeValue(clearOptions);
+```
+
+## 使用说明
+
+### 角标数值说明
+
+- **BadgeValue > 0**: 显示对应的数字角标
+- **BadgeValue = 0**: 清除或隐藏角标
+- **BadgeValue < 0**: 通常不支持负数，可能被忽略或转换为0
+
+### 平台差异
+
+- **iOS**: 完全支持应用角标，显示在应用图标右上角
+- **Android**: 支持情况取决于设备厂商和启动器，部分设备可能不显示
+- **Web端**: 通常不支持应用角标功能
+
+### 使用场景
+
+- 显示未读消息数量
+- 通知计数显示
+- 待处理任务数量
+- 应用内重要事件提醒
+
+## 注意事项
+
+- 此功能主要在移动APP环境中有效
+- Web端调用此方法通常不会产生实际效果
+- Android设备的角标支持因厂商而异
+- 角标数值建议控制在合理范围内（通常99以内）
+- 过大的数值可能被截断显示（如"99+"）
+- 需要用户授权通知权限（某些平台）
+- 角标更新可能有延迟
+- 建议在数据变化时及时更新角标数值
+
+## 相关 API
+
+- [`ClearBadgeValue`](./057-ClearBadgeValue.md) - 清除应用角标
+- [`SetApplicationIconBadgeNumber`](./082-SetApplicationIconBadgeNumber.md) - 设置应用图标角标数字
+- [`ClearApplicationIconBadgeNumber`](./083-ClearApplicationIconBadgeNumber.md) - 清除应用图标角标数字

package/docs/api//345/272/224/347/224/250/347/256/241/347/220/206/057-ClearBadgeValue.md

@@ -0,0 +1,93 @@
+---
+date: 2026-03-06
+permalink: /pages/api-clear-badge-value/
+categories: 
+  - API
+  - 应用控制
+tags: []
+author: { name: AI Assistant }
+---
+
+# ClearBadgeValue - 清除应用角标
+
+## 功能描述
+
+清除应用图标右上角的数字角标。用于移除通知计数或未读消息提示。
+
+## 调用类型
+
+同步类
+
+## 方法说明
+
+```typescript
+ClearBadgeValue(): void
+```
+
+### 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 | 默认值 |
+|--------|------|------|------|--------|
+| 无 | 无 | 否 | 无参数 | 无 |
+
+### 返回值说明
+
+无返回值
+
+## 代码示例
+
+### JavaScript 示例
+
+```javascript
+// 清除应用角标
+mixPublicLib.ClearBadgeValue();
+
+// 在用户查看所有消息后清除角标
+function onAllMessagesRead() {
+  mixPublicLib.ClearBadgeValue();
+}
+```
+
+### TypeScript 示例
+
+```typescript
+// 清除应用角标
+mixPublicLib.ClearBadgeValue();
+```
+
+## 使用说明
+
+### 功能说明
+
+- 完全移除应用图标上的数字角标
+- 等效于调用 `SetBadgeValue({ BadgeValue: 0 })`
+- 清除所有相关的通知计数显示
+
+### 平台差异
+
+- **iOS**: 完全支持清除应用角标
+- **Android**: 支持情况取决于设备厂商和启动器
+- **Web端**: 通常不支持应用角标功能
+
+### 使用场景
+
+- 用户已读取所有通知后清除角标
+- 应用启动时清理旧的角标
+- 手动清除不需要的通知计数
+- 应用退出时清理状态
+
+## 注意事项
+
+- 此功能主要在移动APP环境中有效
+- Web端调用此方法通常不会产生实际效果
+- Android设备的角标清除支持因厂商而异
+- 清除操作可能有短暂延迟
+- 需要用户授权通知权限（某些平台）
+- 清除后无法恢复之前的角标数值
+- 建议在适当的时机调用此方法，如用户完成相关操作后
+
+## 相关 API
+
+- [`SetBadgeValue`](./056-SetBadgeValue.md) - 设置应用角标
+- [`SetApplicationIconBadgeNumber`](./082-SetApplicationIconBadgeNumber.md) - 设置应用图标角标数字
+- [`ClearApplicationIconBadgeNumber`](./083-ClearApplicationIconBadgeNumber.md) - 清除应用图标角标数字

package/docs/api//345/272/224/347/224/250/347/256/241/347/220/206/073-ClearAppCache.md

@@ -0,0 +1,126 @@
+---
+date: 2026-03-06
+permalink: /pages/api-clear-app-cache/
+categories: 
+  - API
+  - 应用控制
+tags: []
+author: { name: AI Assistant }
+---
+
+# ClearAppCache - 清理APP缓存
+
+## 功能描述
+
+清理应用的缓存数据。用于释放存储空间和解决缓存相关问题。
+
+## 调用类型
+
+同步类
+
+## 方法说明
+
+```typescript
+ClearAppCache(): void
+```
+
+### 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 | 默认值 |
+|--------|------|------|------|--------|
+| 无 | 无 | 否 | 无参数 | 无 |
+
+### 返回值说明
+
+无返回值
+
+## 代码示例
+
+### JavaScript 示例
+
+```javascript
+// 清理应用缓存
+mixPublicLib.ClearAppCache();
+
+// 在用户确认后清理缓存
+if (confirm("确定要清理应用缓存吗？这将释放存储空间但可能影响加载速度。")) {
+  mixPublicLib.ClearAppCache();
+  alert("缓存已清理完成");
+}
+
+// 定期清理缓存（例如每月一次）
+const lastClearTime = localStorage.getItem('lastCacheClear');
+const now = Date.now();
+if (!lastClearTime || now - parseInt(lastClearTime) > 30 * 24 * 60 * 60 * 1000) {
+  mixPublicLib.ClearAppCache();
+  localStorage.setItem('lastCacheClear', now.toString());
+}
+```
+
+### TypeScript 示例
+
+```typescript
+// 清理应用缓存
+mixPublicLib.ClearAppCache();
+
+// 带错误处理的缓存清理
+try {
+  mixPublicLib.ClearAppCache();
+  console.log("缓存清理成功");
+} catch (error) {
+  console.error("缓存清理失败:", error);
+}
+```
+
+## 使用说明
+
+### 清理内容
+
+- **Web缓存**: 浏览器缓存、localStorage、sessionStorage等
+- **APP缓存**: 原生应用的临时文件、图片缓存、网络请求缓存等
+- **数据库缓存**: SQLite或其他本地数据库的缓存数据
+- **媒体缓存**: 下载的图片、视频、音频文件缓存
+
+### 平台差异
+
+- **Web端**: 清理浏览器存储和缓存，可能需要用户确认
+- **APP端**: 调用原生方法清理应用缓存目录
+- **iOS/Android**: 原生实现，清理效果更彻底
+
+### 使用场景
+
+- 用户手动清理缓存以释放存储空间
+- 解决应用卡顿或异常问题
+- 强制刷新应用数据
+- 隐私保护（清理敏感缓存数据）
+- 应用版本更新后的缓存清理
+
+## 注意事项
+
+- **数据丢失风险**: 
+  - 缓存清理是不可逆的操作
+  - 可能导致需要重新下载的数据
+  - 影响应用的加载速度和用户体验
+- **权限要求**: 
+  - APP端通常需要存储权限
+  - Web端可能受到浏览器安全策略限制
+- **用户体验**: 
+  - 建议在用户明确确认后执行
+  - 提供清理前后的存储空间对比
+  - 说明清理可能带来的影响
+- **最佳实践**: 
+  - 定期自动清理过期缓存
+  - 提供手动清理的用户入口
+  - 结合具体的业务场景使用
+  - 测试清理后的应用功能完整性
+- **兼容性**: 
+  - 不同平台的清理范围可能不同
+  - 某些系统可能限制缓存清理操作
+  - 老版本设备可能有特殊的缓存管理机制
+
+## 相关 API
+
+- [`MiniAppDelete`](./035-MiniAppDelete.md) - 清除本地所有小程序
+- [`DownloadFileDelete`](./041-DownloadFileDelete.md) - 删除已完成下载
+- [`CacheSize`](./103-CacheSize.md) - 获取缓存大小
+- [`ExitApp`](./074-ExitApp.md) - 退出应用

package/docs/api//345/272/224/347/224/250/347/256/241/347/220/206/074-ExitApp.md

@@ -0,0 +1,138 @@
+---
+date: 2026-03-06
+permalink: /pages/api-exit-app/
+categories: 
+  - API
+  - 应用控制
+tags: []
+author: { name: AI Assistant }
+---
+
+# ExitApp - 退出应用
+
+## 功能描述
+
+退出当前应用程序。用于程序化关闭整个应用。
+
+## 调用类型
+
+同步类
+
+## 方法说明
+
+```typescript
+ExitApp(): void
+```
+
+### 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 | 默认值 |
+|--------|------|------|------|--------|
+| 无 | 无 | 否 | 无参数 | 无 |
+
+### 返回值说明
+
+无返回值
+
+## 代码示例
+
+### JavaScript 示例
+
+```javascript
+// 退出应用
+mixPublicLib.ExitApp();
+
+// 在用户确认后退出应用
+if (confirm("确定要退出应用吗？")) {
+  mixPublicLib.ExitApp();
+}
+
+// 在特定条件下自动退出（如长时间不活动）
+let inactivityTimer;
+function resetInactivityTimer() {
+  clearTimeout(inactivityTimer);
+  inactivityTimer = setTimeout(() => {
+    if (confirm("长时间未操作，是否退出应用？")) {
+      mixPublicLib.ExitApp();
+    }
+  }, 30 * 60 * 1000); // 30分钟后
+}
+
+// 监听用户活动
+document.addEventListener('mousemove', resetInactivityTimer);
+document.addEventListener('keypress', resetInactivityTimer);
+resetInactivityTimer();
+```
+
+### TypeScript 示例
+
+```typescript
+// 退出应用
+mixPublicLib.ExitApp();
+
+// 带错误处理的退出操作
+try {
+  mixPublicLib.ExitApp();
+} catch (error) {
+  console.error("退出应用失败:", error);
+}
+```
+
+## 使用说明
+
+### 功能说明
+
+- 完全关闭当前应用程序
+- 释放所有应用占用的内存和资源
+- 应用进程将被终止
+
+### 平台差异
+
+- **APP端**: 调用原生方法完全退出应用
+- **Web端**: 可能调用 `window.close()` 或提供模拟功能
+- **小程序**: 小程序通常不允许完全退出，可能返回首页或隐藏
+
+### 退出效果
+
+- **APP端**: 应用完全关闭，需要重新启动
+- **Web端**: 可能关闭当前标签页或窗口
+- **后台服务**: 可能同时停止相关的后台服务
+
+### 使用场景
+
+- 用户主动选择退出应用
+- 应用维护或更新时的强制退出
+- 安全敏感操作后的应用退出
+- 长时间不活动的自动退出
+- 错误恢复时的最后手段
+
+## 注意事项
+
+- **用户体验**: 
+  - 退出操作不可逆，用户需要重新启动应用
+  - 建议在退出前保存重要数据
+  - 提供明确的退出确认提示
+- **平台限制**: 
+  - Web端的 `window.close()` 可能受到浏览器安全策略限制
+  - 小程序平台通常不允许完全退出应用
+  - 某些Android版本可能阻止第三方应用完全退出
+- **最佳实践**: 
+  - 仅在必要时使用此功能
+  - 提供优雅的数据保存和清理机制
+  - 考虑使用返回首页等替代方案
+  - 测试不同平台的退出效果
+- **安全考虑**: 
+  - 敏感应用可在退出时清理内存数据
+  - 避免在未经授权的情况下退出应用
+  - 考虑退出前的权限验证
+- **兼容性**: 
+  - 不同平台的退出行为可能不同
+  - 某些设备可能有特殊的退出处理机制
+  - 老版本系统可能有不同的退出API
+
+## 相关 API
+
+- [`DestructionPage`](./054-DestructionPage.md) - 销毁页面
+- [`GoBack`](./008-GoBack.md) - 返回页面
+- [`ReturnHomePage`](./009-ReturnHomePage.md) - 回到根页面
+- [`ClearAppCache`](./073-ClearAppCache.md) - 清理APP缓存