@singcl/ad-execute-manager 1.0.13 → 1.0.14

package/dist/ad/RewardAdNovel.d.ts

@@ -0,0 +1,370 @@
+export default RewardAdNovel;
+export type IRewordAdConfig = import("../typings/ad.js").IRewordAdConfig;
+export type ICallbackArgs = {
+    /**
+     * 广告执行场景
+     */
+    scene: number;
+    /**
+     * 是否看完
+     */
+    isEnded: boolean;
+    /**
+     * 完整观看次数
+     */
+    count: number;
+    /**
+     * 执行下一个任务的回调函数，手动调用以继续执行流程[end]
+     */
+    end?: () => void;
+    /**
+     * 执行下一个任务的回调函数， 手动调用以继续执行流程[circle]
+     */
+    circle?: (args: {
+        ignoreRemain: boolean;
+        scene: number;
+    }) => void;
+};
+export type IConnection = {
+    /**
+     * 广告中途退出回调
+     */
+    onHalfway?: (args: ICallbackArgs) => void;
+    /**
+     * 广告展示回调
+     */
+    onShow?: (args: ICallbackArgs) => void;
+    /**
+     * 广告执行成功回调
+     */
+    onFinish?: (args: ICallbackArgs) => void;
+    /**
+     * 广告执行成功回调
+     */
+    onAlways?: (args: ICallbackArgs) => void;
+    /**
+     * 广告执行失败回调
+     */
+    onError?: (e: unknown) => void;
+};
+export type IConstructArgs = {
+    /**
+     * 初始化标识
+     */
+    sign?: string;
+    /**
+     * 是否保留tt激励视频广告实例
+     */
+    preserveOnEnd?: boolean;
+    /**
+     * 是否需要在超时情况下结束广告
+     */
+    needEndOnTimeout?: boolean;
+    /**
+     * 激励视频参数 (可选)
+     */
+    adConfig?: IRewordAdConfig | undefined;
+    /**
+     * 回调集合
+     */
+    collection?: IConnection | undefined;
+};
+export type ICloseArgs = {
+    /**
+     * 是否看完
+     */
+    isEnded: boolean;
+    /**
+     * 完整观看次数
+     */
+    count: number;
+};
+export type IEndArgs = {
+    /**
+     * 是否解锁全部
+     */
+    can_unlock_all?: boolean;
+    /**
+     * 是否解锁小说
+     */
+    can_unlock_novel?: boolean;
+    /**
+     * 剩余次数
+     */
+    remain?: number;
+    /**
+     * 结束类型
+     */
+    end_type?: "halfway" | "finished";
+};
+export type IRewardedVideoAd = {
+    /**
+     * 显示激励视频广告
+     */
+    show: () => Promise<void>;
+};
+/**
+ * @typedef {import('../typings/ad.js').IRewordAdConfig} IRewordAdConfig
+ */
+/**
+ * @typedef ICallbackArgs
+ * @property {number} scene 广告执行场景
+ * @property {boolean} isEnded 是否看完
+ * @property {number} count 完整观看次数
+ * @property {() => void} [end] 执行下一个任务的回调函数，手动调用以继续执行流程[end]
+ * @property {(args: {ignoreRemain: boolean, scene: number}) => void} [circle] 执行下一个任务的回调函数， 手动调用以继续执行流程[circle]
+ *
+ */
+/**
+ * @typedef IConnection
+ * @property {(args: ICallbackArgs) => void} [onHalfway] 广告中途退出回调
+ * @property {(args: ICallbackArgs) => void} [onShow] 广告展示回调
+ * @property {(args: ICallbackArgs) => void} [onFinish] 广告执行成功回调
+ * @property {(args: ICallbackArgs) => void} [onAlways] 广告执行成功回调
+ * @property {(e:unknown) => void} [onError] 广告执行失败回调
+ */
+/**
+ * @typedef IConstructArgs
+ * @property {string} [sign] 初始化标识
+ * @property {boolean} [preserveOnEnd] 是否保留tt激励视频广告实例
+ * @property {boolean} [needEndOnTimeout] 是否需要在超时情况下结束广告
+ * @property {IRewordAdConfig=} [adConfig] 激励视频参数 (可选)
+ * @property {IConnection=} [collection] 回调集合
+ */
+/**
+ * @typedef ICloseArgs
+ * @property {boolean} isEnded 是否看完
+ * @property {number} count 完整观看次数
+ */
+/**
+ * @typedef IEndArgs
+ * @property {boolean} [can_unlock_all] 是否解锁全部
+ * @property {boolean} [can_unlock_novel] 是否解锁小说
+ * @property {number} [remain] 剩余次数
+ * @property {'halfway' | 'finished'} [end_type] 结束类型
+ *
+ */
+/**
+ * @typedef IRewardedVideoAd
+ * @property {() => Promise.<void>} show 显示激励视频广告
+ */
+declare class RewardAdNovel extends RewardAdFather {
+    /**
+     *
+     * @param {IConstructArgs} args
+     * @returns  {RewardAdNovel}
+     */
+    static build(args: IConstructArgs): RewardAdNovel;
+    /**
+     *
+     * @returns  {RewardAdNovel}
+     */
+    static getInstance(): RewardAdNovel;
+    /**
+     *
+     * @param {IConstructArgs} args
+     * @returns  {RewardAdNovel}
+     */
+    static "new"(args: IConstructArgs): RewardAdNovel;
+    /**
+     * @param {IConstructArgs} args
+     *
+     */
+    constructor(args: IConstructArgs);
+    _onHalfway: any;
+    _onShow: any;
+    _onFinish: any;
+    _onAlways: any;
+    _onError: any;
+    _alwaysCallback: any;
+    _halfwayCallback: any;
+    _finishedCallback: any;
+    _resolve: any;
+    _next: any;
+    /** @type {number} 广告执行场景 */
+    _scene: number;
+    _adTimeout: any;
+    _adTimeoutTime: number;
+    _adBeforeShowTimer: any;
+    _adBeforeShowTime: number;
+    _adSpeedCloseTimer: any;
+    _adSpeedCloseTime: number;
+    _needEndOnTimeout: boolean;
+    /** @deprecated TODO 移除 */
+    _needSpeedEndOnTimeout: boolean;
+    bindAdCloseLister: any;
+    bindAdErrorLister: any;
+    bindAdLoadLister: any;
+    bindApiAdErrorLister: any;
+    _bindShiftCloseLister: any;
+    _bindShiftErrorLister: any;
+    /**
+     * 初始化
+     * 子类可以选择覆盖此方法，或使用默认实现
+     * @param {IRewordAdConfig} args
+     * @param {(v: IRewardedVideoAd) => void} [callback] 初始化成功回调
+     * @returns {this} 当前实例
+     */
+    initialize(args: IRewordAdConfig, callback?: (v: IRewardedVideoAd) => void): this;
+    _initAdLister(): void;
+    /**
+     * @param {object} args
+     * @param {number} [args.retry] 重试次数
+     */
+    _initNovelConfig(args: {
+        retry?: number;
+    }): void;
+    novelConfig: RewardAdNovelConfig;
+    _onInnerExecuteBefore(): any;
+    _onInnerAdShowSuccess(): any;
+    /**
+     * 广告展示超时设置
+     * @param {object} args
+     * @param {string} args.scene 广告执行场景 必填
+     * @param {Function} args.end 结束当前广告任务的回调函数 必填
+     */
+    _setAdTimeout(args: {
+        scene: string;
+        end: Function;
+    }): void;
+    /**
+     * 广告展示前定时器
+     * @param {object} args
+     * @param {string} args.scene 广告执行场景 必填
+     * @param {Function} args.prelude 广告展示前回调函数 可选
+     */
+    _adPreludeInterval(args: {
+        scene: string;
+        prelude: Function;
+    }): void;
+    _clearAdTimeout(): void;
+    get rewardAd(): any;
+    /**
+     * 确保广告按顺序执行
+     * @param {Object} [ctx] 上下文对象，用于传递数据和状态
+     * @param {IRewordAdConfig} [ctx.options] 广告执行选项
+     * @param {import('../typings/ad.js').CallbackCollection} [ctx.collection] 回调集合
+     *
+     * @returns {Promise.<IEndArgs & ICloseArgs | Undefined>}
+     */
+    addExecuteManager(ctx?: {
+        options?: IRewordAdConfig;
+        collection?: import("../typings/ad.js").CallbackCollection;
+    }): Promise<(IEndArgs & ICloseArgs) | undefined>;
+    /**
+     * @param {object} [ctx] 广告执行上下文
+     * @param {import('../typings/ad.js').IRewordAdConfig} [ctx.options] 广告执行选项
+     * @param {import('../typings/ad.js').CallbackCollection} [ctx.collection] 回调集合
+     * @param {Function} next 执行下一个任务的回调函数，手动调用以继续执行流程
+     *
+     * @returns {Promise.<IEndArgs & ICloseArgs | Undefined>}
+     */
+    ad(ctx?: {
+        options?: import("../typings/ad.js").IRewordAdConfig;
+        collection?: import("../typings/ad.js").CallbackCollection;
+    }, next?: Function): Promise<(IEndArgs & ICloseArgs) | undefined>;
+    /**
+     * @param {object} [ctx] 广告执行上下文
+     * @param {object} [ctx.options] 广告执行选项
+     * @param {number} [ctx.options.scene] 广告执行场景
+     * @param {object} ctx.collection 回调集合
+     * @param {(v?: unknown) => void} ctx.collection.resolve 广告执行成功的回调函数
+     * @param {(v?: unknown) => void} [ctx.collection.reject] 广告执行失败的回调函数
+     * @param {(v?: unknown) => void} [ctx.collection.before] 广告执行前的回调函数
+     * @param {(v?: unknown) => void} [ctx.collection.success] 广告执行成功的回调函数
+     * @param {(v?: unknown) => void} [ctx.collection.prelude] 拉起广告前计时的回调函数
+     * @param {Function} next 执行下一个任务的回调函数，手动调用以继续执行流程
+     */
+    _adInner(ctx?: {
+        options?: {
+            scene?: number;
+        };
+        collection: {
+            resolve: (v?: unknown) => void;
+            reject?: (v?: unknown) => void;
+            before?: (v?: unknown) => void;
+            success?: (v?: unknown) => void;
+            prelude?: (v?: unknown) => void;
+        };
+    }, next?: Function): void;
+    _before: (v?: unknown) => void;
+    _success: (v?: unknown) => void;
+    /**
+     * 广告加载
+     * @returns
+     */
+    adLoad(): Promise<void>;
+    /**
+     * 广告展示
+     * @returns
+     */
+    adShow(): Promise<void>;
+    _outerCloseCallback(args: any): void;
+    _outerHalfwayCallback(args: any): void;
+    _outerFinishedCallback(args: any): void;
+    /**
+     * 关闭激励视频
+     * @param {ICloseArgs} args
+     */
+    adCloseLister(args: ICloseArgs): void;
+    adErrorLister(e: any): void;
+    apiAdErrorLister(e: any): void;
+    /**
+     * 激励视频广告组件**成功**拉取广告素材时会触发
+     * 创建激励时候后会自动拉取广告素材，如果广告拉取成功，也会触发此事件，不管是否调用show方法
+     * @param {unknown} e
+     */
+    adLoadLister(e: unknown): void;
+    adDestroy(): void;
+    _shiftCloseLister(args: any): void;
+    _shiftErrorLister(args: any): void;
+    /**
+     * 手动出栈
+     */
+    shift(): void;
+}
+import RewardAdFather from './RewardAdFather.js';
+declare class RewardAdNovelConfig {
+    /**
+     *
+     * @param {object} args
+     * @param {string} args.sign 初始化标识
+     * @param {number} [args.retry] 重试次数
+     * @returns  {RewardAdNovelConfig}
+     */
+    static "new"(args: {
+        sign: string;
+        retry?: number;
+    }): RewardAdNovelConfig;
+    /**
+     *
+     * @param {object} [args]
+     * @param {number} [args.retry]
+     */
+    constructor(args?: {
+        retry?: number;
+    });
+    frequency: {
+        total: number;
+        current: number;
+    };
+    /**
+     *
+     * @param {object} [args]
+     * @param {number} [args.retry]
+     */
+    _init(args?: {
+        retry?: number;
+    }): void;
+    /**
+     *
+     * @param {object} [args]
+     * @param {number} [args.retry]
+     */
+    _adTimes(args?: {
+        retry?: number;
+    }): void;
+    reset(): void;
+    updateRetry(): void;
+    remain(): number;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@singcl/ad-execute-manager",
-  "version": "1.0.13",
+  "version": "1.0.14",
   "type": "module",
   "exports": {
     ".": {