@hlw-uni/mp-vue 2.2.8 → 2.3.1

package/dist/index.js

@@ -410,6 +410,15 @@ var __publicField = (obj, key, value) => {
     });
     return current;
   }
+  function destroyRewardAd(adId) {
+    adInstances.delete(adId);
+    if (activeRewardId === adId) {
+      activeRewardId = "";
+      rewardCallback = void 0;
+      rewardResolve = null;
+      rewardPromise = null;
+    }
+  }
   function confirmRewardAd() {
     return new Promise((resolve) => {
       uni.showModal({
@@ -434,7 +443,8 @@ var __publicField = (obj, key, value) => {
       showPopupAd,
       setRewardAd,
       showRewardAd,
-      confirmRewardAd
+      confirmRewardAd,
+      destroyRewardAd
     };
   }
   function withQuery(url, qs) {
@@ -1163,6 +1173,7 @@ var __publicField = (obj, key, value) => {
   exports2.confirmRewardAd = confirmRewardAd;
   exports2.copy = copy;
   exports2.cosAdapter = cosAdapter;
+  exports2.destroyRewardAd = destroyRewardAd;
   exports2.download = download;
   exports2.fontFamilyPresets = fontFamilyPresets;
   exports2.fontSizePresets = fontSizePresets;

package/dist/index.mjs

@@ -409,6 +409,15 @@ function showRewardAd(onShowSuccess) {
   });
   return current;
 }
+function destroyRewardAd(adId) {
+  adInstances.delete(adId);
+  if (activeRewardId === adId) {
+    activeRewardId = "";
+    rewardCallback = void 0;
+    rewardResolve = null;
+    rewardPromise = null;
+  }
+}
 function confirmRewardAd() {
   return new Promise((resolve) => {
     uni.showModal({
@@ -433,7 +442,8 @@ function useHlwAd() {
     showPopupAd,
     setRewardAd,
     showRewardAd,
-    confirmRewardAd
+    confirmRewardAd,
+    destroyRewardAd
   };
 }
 function withQuery(url, qs) {
@@ -1163,6 +1173,7 @@ export {
   confirmRewardAd,
   copy,
   cosAdapter,
+  destroyRewardAd,
   download,
   fontFamilyPresets,
   fontSizePresets,

package/dist/utils/ad/index.d.ts

@@ -43,6 +43,12 @@ export declare function setRewardAd(adId: string, done?: (res: AdRes) => void):
  * @returns 返回 Promise<AdRes>，指示广告是否正常播放完毕
  */
 export declare function showRewardAd(onShowSuccess?: () => void): Promise<AdRes>;
+/**
+ * 销毁指定 Unit ID 的激励视频广告实例，释放内存与原生渲染层绑定并清除缓存。
+ *
+ * @param adId 广告单元 ID
+ */
+export declare function destroyRewardAd(adId: string): void;
 /**
  * 弹窗提示需要看完广告才有奖励。
  * 提供“继续观看”和“取消”按钮。
@@ -58,4 +64,5 @@ export declare function useHlwAd(): {
     setRewardAd: typeof setRewardAd;
     showRewardAd: typeof showRewardAd;
     confirmRewardAd: typeof confirmRewardAd;
+    destroyRewardAd: typeof destroyRewardAd;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@hlw-uni/mp-vue",
-    "version": "2.2.8",
+    "version": "2.3.1",
     "description": "hlw-uni 小程序运行时 — Vue 组件 + composables + theme + http + 工具集（合并自原 mp-core）",
     "main": "dist/index.js",
     "module": "dist/index.mjs",

package/src/components/hlw-reward-ad/index.vue

@@ -5,8 +5,8 @@
 </template>
 
 <script setup lang="ts">
-import { ref, onMounted, watch } from "vue";
-import { setRewardAd, showRewardAd, confirmRewardAd } from "../../utils/ad";
+import { ref, onMounted, watch, onUnmounted } from "vue";
+import { setRewardAd, showRewardAd, confirmRewardAd, destroyRewardAd } from "../../utils/ad";
 
 defineOptions({ name: "HlwRewardAd" });
 
@@ -18,7 +18,7 @@ interface Props {
 const props = defineProps<Props>();
 
 const emit = defineEmits<{
-    (e: "onHandle", res: { success: boolean; isEnded: boolean; err?: any }): void;
+    (e: "onHandle", res: { success: boolean; isEnded: boolean; loadFailed?: boolean; err?: any }): void;
 }>();
 
 // 点击锁定状态，防止连续多次点击重复触发广告
@@ -84,6 +84,7 @@ async function playRewardAdFlow(): Promise<void> {
             emit("onHandle", {
                 success: false,
                 isEnded: false,
+                loadFailed: true,
                 err: res.err,
             });
         } else {
@@ -105,6 +106,7 @@ async function playRewardAdFlow(): Promise<void> {
         emit("onHandle", {
             success: false,
             isEnded: false,
+            loadFailed: true,
             err: e,
         });
     }
@@ -146,6 +148,10 @@ defineExpose({
         }
     }
 });
+
+onUnmounted(() => {
+    destroyRewardAd(props.unitId);
+});
 </script>
 
 <style scoped>

package/src/utils/ad/index.ts

@@ -196,6 +196,24 @@ export function showRewardAd(onShowSuccess?: () => void): Promise<AdRes> {
     return current;
 }
 
+/**
+ * 销毁指定 Unit ID 的激励视频广告实例，释放内存与原生渲染层绑定并清除缓存。
+ * 
+ * @param adId 广告单元 ID
+ */
+export function destroyRewardAd(adId: string) {
+    // 仅从本地缓存 Map 中移除该广告单元的实例引用，并清理相关状态，严禁调用 ad.destroy()
+    // 因为微信小程序的 wx.createRewardedVideoAd 在整个应用生命周期中为全局单例，
+    // 一旦销毁 (destroy) 后，后续再次 create 该广告位 ID 将永远返回已销毁的实例，导致报错 "video-ad has been destroyed"
+    adInstances.delete(adId);
+    if (activeRewardId === adId) {
+        activeRewardId = "";
+        rewardCallback = undefined;
+        rewardResolve = null;
+        rewardPromise = null;
+    }
+}
+
 /**
  * 弹窗提示需要看完广告才有奖励。
  * 提供“继续观看”和“取消”按钮。
@@ -230,5 +248,6 @@ export function useHlwAd() {
         setRewardAd,
         showRewardAd,
         confirmRewardAd,
+        destroyRewardAd,
     };
 }