/** * 小程序广告工具。 * 提供插屏广告 (Interstitial Ad) 与激励视频广告 (Rewarded Video Ad) 的注册、缓存与展示能力。 */ /** * 广告播放/加载结果数据结构。 */ export interface AdRes { /** 广告是否正常加载或成功展示完成 */ success: boolean; /** 激励视频是否完全播放完毕 (仅激励视频有此属性) */ isEnded: boolean; /** 加载或展示失败时的错误对象 */ err?: any; } /** * 配置/预加载插屏广告 * * @param adId 广告单元 ID * @param done 广告关闭后的回调(可选) * @returns 是否配置成功 */ export declare function setPopupAd(adId: string, done?: (ok: boolean) => void): boolean; /** * 延迟展示已配置的插屏广告 * * @param delay 延迟毫秒数,默认 3000ms * @returns 返回 Promise,指示是否成功显示且被关闭 */ export declare function showPopupAd(delay?: number): Promise; /** * 配置/预加载激励视频广告 * * @param adId 广告单元 ID * @param done 播放结束的回调(可选) * @returns 返回 Promise */ export declare function setRewardAd(adId: string, done?: (res: AdRes) => void): Promise; /** * 立即播放已加载的激励视频广告 * * @param onShowSuccess 广告成功拉起播放时的回调(常用于关闭 Loading 等待提示) * @returns 返回 Promise,指示广告是否正常播放完毕 */ export declare function showRewardAd(onShowSuccess?: () => void): Promise; /** * 销毁指定 Unit ID 的激励视频广告实例,释放内存与原生渲染层绑定并清除缓存。 * * @param adId 广告单元 ID */ export declare function destroyRewardAd(adId: string): void; /** * 弹窗提示需要看完广告才有奖励。 * 提供“继续观看”和“取消”按钮。 * @returns 返回 Promise,用户点击“继续”返回 true,点击“取消”返回 false */ export declare function confirmRewardAd(): Promise; /** * @deprecated 推荐直接从库导入独立函数使用 (例如:import { showRewardAd } from '@hlw-uni/mp-vue') */ export declare function useHlwAd(): { setPopupAd: typeof setPopupAd; showPopupAd: typeof showPopupAd; setRewardAd: typeof setRewardAd; showRewardAd: typeof showRewardAd; confirmRewardAd: typeof confirmRewardAd; destroyRewardAd: typeof destroyRewardAd; };