@docoi/mys-sdk 1.1.0 → 1.2.0

package/README.md

@@ -156,7 +156,7 @@ await mys.startRecordAudio({
 | 页面跳转     | `switchTab` `navigateTo` `openWebview` `openInExternalBrowser` `closeWebView` `openScheme`                  |
 | 账号与用户   | `login` `getToken` `getCurrentCircleInfo`                                                                  |
 | 内容与分享   | `shareWebCard` `shareImage` `openAddCustomEmoji` `openCommentPanel` `showLongVipDesDialog` `voteAction` `openFriendsList` |
-| 业务场景     | `toBindGameRole` `bindGameRoleSuccess` `showAd` `onAdFinished` / `offAdFinished` `updateData` `openGiftBag` `onMemberActivate` / `offMemberActivate` |
+| 业务场景     | `toBindGameRole` `bindGameRoleSuccess` `showAd` `updateData` `openGiftBag` `onMemberActivate` / `offMemberActivate` |
 | 工具         | `setDebug` `registerNativeHandler`                                                                          |
 
 `getAppBaseInfo` / `isInApp` / `compareVersions` 用来读 App 环境信息，`ToastDuration` / `ShareType` 是枚举值。`onRoute` / `invokeDebug` 仅供仓库内的 Demo 调试，不承诺兼容，业务侧不要依赖。

package/dist/api/biz.d.ts

@@ -1,4 +1,4 @@
-import { Callbacks, NativeResponse, EventListenOptions, ShareWebCardParams, ShareImageParams, ShareImageResult, ShowAdParams, BindGameRoleParams, OpenCommentPanelParams, VoteActionParams, OpenGiftBagParams, OpenFriendsListParams, OpenFriendsListResult, UpdateDataParams, LoginResult, GetTokenResult, GetCircleInfoResult, VoteData, AdFinishedCallback, MemberActivateHandler } from '../types';
+import { Callbacks, NativeResponse, ShareWebCardParams, ShareImageParams, ShareImageResult, ShowAdParams, BindGameRoleParams, OpenCommentPanelParams, VoteActionParams, OpenGiftBagParams, OpenFriendsListParams, OpenFriendsListResult, UpdateDataParams, LoginResult, GetTokenResult, GetCircleInfoResult, VoteData, MemberActivateHandler } from '../types';
 /**
  * 登录授权。
  *
@@ -147,32 +147,20 @@ export declare function bindGameRoleSuccess(params?: Callbacks): Promise<NativeR
 /**
  * 展示原生广告视频。
  *
- * @note 广告播放完成后 Native 通过 onAdFinished 事件通知。
+ * @note 广告播放完成后通过 onFinished 回调通知，不需要单独监听事件；只有 Native 回传的 module 与 params.module 一致时才触发。
+ * @note onFinished 不需要手动取消，触发一次后自动取消；同一个 module 只保留最近一次调用的 onFinished，不同 module 互不影响，调用失败也不会取消。
  *
  * @app 3.9.0
  * @example
- * await mys.showAd({ type: 1, params: { circle_id: '123', module: 1 } })
- */
-export declare function showAd(params: ShowAdParams): Promise<NativeResponse<void>>;
-/**
- * 监听广告播放完成。
- *
- * @app 3.7.0
- * @example
- * mys.onAdFinished((res) => {
- *   console.log(res.module)
+ * await mys.showAd({
+ *   type: 1,
+ *   params: { circle_id: '123', module: 1 },
+ *   onFinished: (res) => {
+ *     console.log('广告播放完成', res.module)
+ *   },
  * })
  */
-export declare function onAdFinished(callback: AdFinishedCallback, options?: EventListenOptions): void;
-/**
- * 取消监听广告播放完成。
- *
- * @param callback 要取消的监听函数，不传则取消全部广告播放完成监听
- * @app 3.7.0
- * @example
- * mys.offAdFinished()
- */
-export declare function offAdFinished(callback?: AdFinishedCallback): void;
+export declare function showAd(params: ShowAdParams): Promise<NativeResponse<void>>;
 /**
  * 通知 Native 更新数据。
  *
@@ -185,9 +173,19 @@ export declare function updateData(params: UpdateDataParams): Promise<NativeResp
 /**
  * 打开客户端背包。
  *
+ * @note 送礼成功后通过 onSent 回调通知，不需要单独监听事件。
+ * @note onSent 不需要手动取消，调用失败或下一次调用 openGiftBag 时自动取消；每次送礼成功都会触发。
+ *
  * @app 3.2.0
  * @example
- * await mys.openGiftBag({ user_id: 'u1', server_id: 's123', openBag: true })
+ * await mys.openGiftBag({
+ *   user_id: 'u1',
+ *   server_id: 's123',
+ *   openBag: true,
+ *   onSent: (res) => {
+ *     console.log('送礼成功', res.gift_id, res.gift_name)
+ *   },
+ * })
  */
 export declare function openGiftBag(params: OpenGiftBagParams): Promise<NativeResponse<void>>;
 /**

package/dist/api/router/index.d.ts

@@ -16,7 +16,7 @@ export declare function switchTab(params: SwitchTabParams): Promise<NativeRespon
  *
  * @note 不在 App 内时唤起 App，唤起失败（超时仍停留在当前页）时触发 onLaunchFail，由业务侧引导下载。
  * @note 唤起 App 和 App 4.4.0 以下的跳转都是发出即成功，不代表页面已打开。
- * @note App 4.4.0 以下能否跳转取决于目标页面自己的起始版本，不支持的返回 ENV_UNSUPPORTED（5002）；绑定游戏角色、添加自定义表情页面在低版本仍可用。
+ * @note App 4.4.0 以下能否跳转取决于目标页面自己的起始版本，不支持的返回 ENV_UNSUPPORTED（5002）；动态发布、资料编辑、点赞列表、广告页、绑定游戏角色、添加自定义表情页面在低版本仍可用。
  *
  * @app 4.4.0
  * @paramsMap NavigatePageParamsMap

package/dist/api/router/routes.d.ts

@@ -68,6 +68,9 @@ export declare const PAGE_ROUTES: {
                     publish: string;
                 };
             };
+            publishType: {
+                key: string;
+            };
             relationType: {
                 key: string;
                 enum: {
@@ -333,6 +336,23 @@ export declare const PAGE_ROUTES: {
         since: string;
         fields: {};
     };
+    dynamicPublishPage: {
+        type: number;
+        name: string;
+        since: string;
+        fields: {
+            serverId: {
+                key: string;
+                required: true;
+            };
+            channelId: {
+                key: string;
+            };
+            publishType: {
+                key: string;
+            };
+        };
+    };
 };
 /** navigateTo 页面 + switchTab / openWebview 的路由，key 为语义名 */
 export declare const ROUTES: {
@@ -442,6 +462,9 @@ export declare const ROUTES: {
                     publish: string;
                 };
             };
+            publishType: {
+                key: string;
+            };
             relationType: {
                 key: string;
                 enum: {
@@ -707,6 +730,23 @@ export declare const ROUTES: {
         since: string;
         fields: {};
     };
+    dynamicPublishPage: {
+        type: number;
+        name: string;
+        since: string;
+        fields: {
+            serverId: {
+                key: string;
+                required: true;
+            };
+            channelId: {
+                key: string;
+            };
+            publishType: {
+                key: string;
+            };
+        };
+    };
 };
 export type RouteKey = keyof typeof ROUTES;
 /** daoke type → 路由，未登记的 type 返回 undefined */