release: 1.4.7

2026-04-22 17:44:49 +08:00
parent 79f478dd5f
commit e38e066a2d
37 changed files with 2598 additions and 78 deletions
--- a/Assets/Samples/IAAAdDebugSample/Configs.meta
+++ b/Assets/Samples/IAAAdDebugSample/Configs.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 1385bb12efc24cb43a93bb40ace7ea14
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/Samples/IAAAdDebugSample/Configs/IAAAdDebugSampleConfig.asset
+++ b/Assets/Samples/IAAAdDebugSample/Configs/IAAAdDebugSampleConfig.asset
@@ -0,0 +1,48 @@
+%YAML 1.1
+%TAG !u! tag:unity3d.com,2011:
+--- !u!114 &11400000
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 0}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: 98b31b835f394db4a51957c3f0f3ac32, type: 3}
+  m_Name: IAAAdDebugSampleConfig
+  m_EditorClassIdentifier: 
+  ConfigName: IAA Ad Debug Sample
+  Id: your_taku_app_id
+  Key: your_taku_app_key
+  Key2: 
+  BaseAwardAdKeyValue:
+    key: rewarded
+    value: your_rewarded_placement_id
+  BaseInteractionAdKeyValue:
+    key: interstitial
+    value: your_interstitial_placement_id
+  BaseSplashAdKeyValue:
+    key: splash
+    value: optional_splash_placement
+  CommonKeyValues:
+  - key: topon.debug
+    value: true
+  - key: topon.auto_open_debugger_ui
+    value: false
+  - key: topon.rewarded_auto_load
+    value: true
+  - key: topon.rewarded_prewarm_on_init
+    value: true
+  - key: topon.rewarded_max_load_attempts
+    value: 3
+  - key: topon.rewarded_load_retry_delay_ms
+    value: 1000
+  - key: topon.interstitial_auto_load
+    value: true
+  - key: topon.interstitial_prewarm_on_init
+    value: true
+  - key: topon.interstitial_max_load_attempts
+    value: 2
+  - key: topon.interstitial_load_retry_delay_ms
+    value: 500
--- a/Assets/Samples/IAAAdDebugSample/Configs/IAAAdDebugSampleConfig.asset.meta
+++ b/Assets/Samples/IAAAdDebugSample/Configs/IAAAdDebugSampleConfig.asset.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 5acf750d60576674597ee314d6a39cf8
+NativeFormatImporter:
+  externalObjects: {}
+  mainObjectFileID: 11400000
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/Samples/IAAAdDebugSample/README.md
+++ b/Assets/Samples/IAAAdDebugSample/README.md
@@ -0,0 +1,112 @@
+# IAA Ad Debug Sample
+
+## 文件位置
+
+- 场景：
+  - `Assets/Samples/IAAAdDebugSample/Scenes/IAAAdDebugSample.unity`
+- 示例配置：
+  - `Assets/Samples/IAAAdDebugSample/Configs/IAAAdDebugSampleConfig.asset`
+
+## 使用步骤
+
+1. 打开示例配置资产 `IAAAdDebugSampleConfig.asset`
+2. 填入以下字段：
+   - `Id` = Taku AppId
+   - `Key` = Taku AppKey
+   - `BaseAwardAdKeyValue.value` = 激励视频广告位ID
+   - `BaseInteractionAdKeyValue.value` = 插屏广告位ID
+3. 打开示例场景 `IAAAdDebugSample.unity`
+4. 运行到 Android 手机测试
+
+## 当前默认策略
+
+- SDK Debug
+  - `topon.debug=true`
+  - `topon.auto_open_debugger_ui=false`
+- 激励视频
+  - 自动加载：开启
+  - 初始化预热：开启
+  - 最大加载尝试次数：3
+  - 首轮失败补偿：1000ms
+
+- 插屏广告
+  - 自动加载：开启
+  - 初始化预热：开启
+  - 最大加载尝试次数：2
+  - 首轮失败补偿：500ms
+
+## 场景里的 IMGUI 面板支持
+
+- 初始化 ADManager
+- 打开官方 DebugUI
+- 手动 Enter Rewarded / Interstitial Scene
+- 手动 Load 激励 / 插屏
+- AsyncPlay 激励 / 插屏
+- 查看当前屏幕分辨率和 SafeArea
+- 查看当前策略状态
+- 手动刷新状态快照，避免高频状态查询刷满日志
+- 查看 Rewarded / Interstitial 的状态 JSON
+- 一键复制全部日志
+- 自动写入本地 session log 文件
+- 一键导出当前面板可见日志到单独文件
+- 一键复制日志文件路径
+- 查看诊断日志
+
+## 关于 Debug 模式
+
+- `topon.debug=true` 只用于打开 SDK 调试日志
+- 不会再因为 debug 模式自动弹出官方 DebugUI
+- 官方 DebugUI 改为手动点击 `Open DebugUI`
+
+## 场景到达测试方式
+
+推荐验证两条链路：
+
+1. 先点击 `Enter Rewarded Scene`，再点击 `Async Play Rewarded`
+2. 不点击 `Enter Rewarded Scene`，直接点击 `Async Play Rewarded`
+
+当前实现逻辑：
+
+- 如果提前调用了 `EnterAdScenario`
+  - 播放时不会重复上报场景
+- 如果没有提前调用
+  - 播放时不再自动补“场景到达”统计
+
+## 建议测试流程
+
+1. 打开场景并运行到真机
+2. 点击 `Initialize ADManager`
+3. 点击 `Open DebugUI`，确认 SDK Debug 面板可打开
+4. 点击 `Enter Rewarded Scene`
+5. 点击 `Async Play Rewarded`
+6. 点击 `Enter Interstitial Scene`
+7. 点击 `Async Play Interstitial`
+8. 点击 `Copy All Logs`
+9. 将日志直接粘贴给 Codex 分析
+
+如果日志太长，不适合走剪贴板：
+
+1. 点击 `Export Logs To File`
+2. 点击 `Copy Log File Path`
+3. 到真机的 `Application.persistentDataPath/IAAAdDebugLogs` 下取出日志文件
+4. 将文件内容发给 Codex 分析
+
+## 关于分辨率
+
+当前 IMGUI 布局按 `1080 x 2340` 纵向手机做参考设计，并根据 `SafeArea` 自动缩放，适合作为真机调试面板。
+
+## 关于签名
+
+当前示例只负责在 Unity 内和 Android 调试时验证广告链路。
+
+- 不需要官方提供签名
+- 只有在你要正式导出 APK / AAB 时，才需要你自己的包名和签名配置
+
+## 关于日志文件位置
+
+- 运行时会自动创建一份 session log
+- 目录：`Application.persistentDataPath/IAAAdDebugLogs`
+- Android 上通常类似：
+  - `/storage/emulated/0/Android/data/<包名>/files/IAAAdDebugLogs`
+- 当前测试包名是：
+  - `com.foldcc.starveg`
--- a/Assets/Samples/IAAAdDebugSample/README.md.meta
+++ b/Assets/Samples/IAAAdDebugSample/README.md.meta
@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: a116cafc1b2af4441a5b9b3213aa0b1a
+TextScriptImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/Samples/IAAAdDebugSample/Scenes.meta
+++ b/Assets/Samples/IAAAdDebugSample/Scenes.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 79b714e45b20df34490a0062dcbafdd6
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/Samples/IAAAdDebugSample/Scenes/IAAAdDebugSample.unity
+++ b/Assets/Samples/IAAAdDebugSample/Scenes/IAAAdDebugSample.unity
@@ -0,0 +1,274 @@
+%YAML 1.1
+%TAG !u! tag:unity3d.com,2011:
+--- !u!29 &1
+OcclusionCullingSettings:
+  m_ObjectHideFlags: 0
+  serializedVersion: 2
+  m_OcclusionBakeSettings:
+    smallestOccluder: 5
+    smallestHole: 0.25
+    backfaceThreshold: 100
+  m_SceneGUID: 00000000000000000000000000000000
+  m_OcclusionCullingData: {fileID: 0}
+--- !u!104 &2
+RenderSettings:
+  m_ObjectHideFlags: 0
+  serializedVersion: 9
+  m_Fog: 0
+  m_FogColor: {r: 0.5, g: 0.5, b: 0.5, a: 1}
+  m_FogMode: 3
+  m_FogDensity: 0.01
+  m_LinearFogStart: 0
+  m_LinearFogEnd: 300
+  m_AmbientSkyColor: {r: 0.212, g: 0.227, b: 0.259, a: 1}
+  m_AmbientEquatorColor: {r: 0.114, g: 0.125, b: 0.133, a: 1}
+  m_AmbientGroundColor: {r: 0.047, g: 0.043, b: 0.035, a: 1}
+  m_AmbientIntensity: 1
+  m_AmbientMode: 3
+  m_SubtractiveShadowColor: {r: 0.42, g: 0.478, b: 0.627, a: 1}
+  m_SkyboxMaterial: {fileID: 0}
+  m_HaloStrength: 0.5
+  m_FlareStrength: 1
+  m_FlareFadeSpeed: 3
+  m_HaloTexture: {fileID: 0}
+  m_SpotCookie: {fileID: 10001, guid: 0000000000000000e000000000000000, type: 0}
+  m_DefaultReflectionMode: 0
+  m_DefaultReflectionResolution: 128
+  m_ReflectionBounces: 1
+  m_ReflectionIntensity: 1
+  m_CustomReflection: {fileID: 0}
+  m_Sun: {fileID: 0}
+  m_UseRadianceAmbientProbe: 0
+--- !u!157 &3
+LightmapSettings:
+  m_ObjectHideFlags: 0
+  serializedVersion: 12
+  m_GIWorkflowMode: 1
+  m_GISettings:
+    serializedVersion: 2
+    m_BounceScale: 1
+    m_IndirectOutputScale: 1
+    m_AlbedoBoost: 1
+    m_EnvironmentLightingMode: 0
+    m_EnableBakedLightmaps: 0
+    m_EnableRealtimeLightmaps: 0
+  m_LightmapEditorSettings:
+    serializedVersion: 12
+    m_Resolution: 2
+    m_BakeResolution: 40
+    m_AtlasSize: 1024
+    m_AO: 0
+    m_AOMaxDistance: 1
+    m_CompAOExponent: 1
+    m_CompAOExponentDirect: 0
+    m_ExtractAmbientOcclusion: 0
+    m_Padding: 2
+    m_LightmapParameters: {fileID: 0}
+    m_LightmapsBakeMode: 1
+    m_TextureCompression: 1
+    m_FinalGather: 0
+    m_FinalGatherFiltering: 1
+    m_FinalGatherRayCount: 256
+    m_ReflectionCompression: 2
+    m_MixedBakeMode: 2
+    m_BakeBackend: 1
+    m_PVRSampling: 1
+    m_PVRDirectSampleCount: 32
+    m_PVRSampleCount: 512
+    m_PVRBounces: 2
+    m_PVREnvironmentSampleCount: 256
+    m_PVREnvironmentReferencePointCount: 2048
+    m_PVRFilteringMode: 1
+    m_PVRDenoiserTypeDirect: 1
+    m_PVRDenoiserTypeIndirect: 1
+    m_PVRDenoiserTypeAO: 1
+    m_PVRFilterTypeDirect: 0
+    m_PVRFilterTypeIndirect: 0
+    m_PVRFilterTypeAO: 0
+    m_PVREnvironmentMIS: 1
+    m_PVRCulling: 1
+    m_PVRFilteringGaussRadiusDirect: 1
+    m_PVRFilteringGaussRadiusIndirect: 5
+    m_PVRFilteringGaussRadiusAO: 2
+    m_PVRFilteringAtrousPositionSigmaDirect: 0.5
+    m_PVRFilteringAtrousPositionSigmaIndirect: 2
+    m_PVRFilteringAtrousPositionSigmaAO: 1
+    m_ExportTrainingData: 0
+    m_TrainingDataDestination: TrainingData
+    m_LightProbeSampleCountMultiplier: 4
+  m_LightingDataAsset: {fileID: 0}
+  m_LightingSettings: {fileID: 0}
+--- !u!196 &4
+NavMeshSettings:
+  serializedVersion: 2
+  m_ObjectHideFlags: 0
+  m_BuildSettings:
+    serializedVersion: 3
+    agentTypeID: 0
+    agentRadius: 0.5
+    agentHeight: 2
+    agentSlope: 45
+    agentClimb: 0.4
+    ledgeDropHeight: 0
+    maxJumpAcrossDistance: 0
+    minRegionArea: 2
+    manualCellSize: 0
+    cellSize: 0.16666667
+    manualTileSize: 0
+    tileSize: 256
+    buildHeightMesh: 0
+    maxJobWorkers: 0
+    preserveTilesOutsideBounds: 0
+    debug:
+      m_Flags: 0
+  m_NavMeshData: {fileID: 0}
+--- !u!1 &320557560
+GameObject:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  serializedVersion: 6
+  m_Component:
+  - component: {fileID: 320557563}
+  - component: {fileID: 320557562}
+  - component: {fileID: 320557561}
+  m_Layer: 0
+  m_Name: Main Camera
+  m_TagString: MainCamera
+  m_Icon: {fileID: 0}
+  m_NavMeshLayer: 0
+  m_StaticEditorFlags: 0
+  m_IsActive: 1
+--- !u!81 &320557561
+AudioListener:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 320557560}
+  m_Enabled: 1
+--- !u!20 &320557562
+Camera:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 320557560}
+  m_Enabled: 1
+  serializedVersion: 2
+  m_ClearFlags: 1
+  m_BackGroundColor: {r: 0.19215687, g: 0.3019608, b: 0.4745098, a: 0}
+  m_projectionMatrixMode: 1
+  m_GateFitMode: 2
+  m_FOVAxisMode: 0
+  m_Iso: 200
+  m_ShutterSpeed: 0.005
+  m_Aperture: 16
+  m_FocusDistance: 10
+  m_FocalLength: 50
+  m_BladeCount: 5
+  m_Curvature: {x: 2, y: 11}
+  m_BarrelClipping: 0.25
+  m_Anamorphism: 0
+  m_SensorSize: {x: 36, y: 24}
+  m_LensShift: {x: 0, y: 0}
+  m_NormalizedViewPortRect:
+    serializedVersion: 2
+    x: 0
+    y: 0
+    width: 1
+    height: 1
+  near clip plane: 0.3
+  far clip plane: 1000
+  field of view: 60
+  orthographic: 1
+  orthographic size: 5
+  m_Depth: -1
+  m_CullingMask:
+    serializedVersion: 2
+    m_Bits: 4294967295
+  m_RenderingPath: -1
+  m_TargetTexture: {fileID: 0}
+  m_TargetDisplay: 0
+  m_TargetEye: 3
+  m_HDR: 1
+  m_AllowMSAA: 1
+  m_AllowDynamicResolution: 0
+  m_ForceIntoRT: 0
+  m_OcclusionCulling: 1
+  m_StereoConvergence: 10
+  m_StereoSeparation: 0.022
+--- !u!4 &320557563
+Transform:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 320557560}
+  serializedVersion: 2
+  m_LocalRotation: {x: 0, y: 0, z: 0, w: 1}
+  m_LocalPosition: {x: 0, y: 0, z: -10}
+  m_LocalScale: {x: 1, y: 1, z: 1}
+  m_ConstrainProportionsScale: 0
+  m_Children: []
+  m_Father: {fileID: 0}
+  m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
+--- !u!1 &924544598
+GameObject:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  serializedVersion: 6
+  m_Component:
+  - component: {fileID: 924544600}
+  - component: {fileID: 924544599}
+  m_Layer: 0
+  m_Name: IAA Ad Debug Sample
+  m_TagString: Untagged
+  m_Icon: {fileID: 0}
+  m_NavMeshLayer: 0
+  m_StaticEditorFlags: 0
+  m_IsActive: 1
+--- !u!114 &924544599
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 924544598}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: 53b297b9bf0d4cfca2b77af0fd74c95c, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  adConfig: {fileID: 11400000, guid: 5acf750d60576674597ee314d6a39cf8, type: 2}
+  userId: debug_user_001
+  rewardedScenario: reward_debug
+  interstitialScenario: interstitial_debug
+  autoInitialize: 1
+  forcePortrait: 1
+  captureUnityLogs: 1
+  showVerboseState: 1
+--- !u!4 &924544600
+Transform:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 924544598}
+  serializedVersion: 2
+  m_LocalRotation: {x: 0, y: 0, z: 0, w: 1}
+  m_LocalPosition: {x: 0, y: 0, z: 0}
+  m_LocalScale: {x: 1, y: 1, z: 1}
+  m_ConstrainProportionsScale: 0
+  m_Children: []
+  m_Father: {fileID: 0}
+  m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
+--- !u!1660057539 &9223372036854775807
+SceneRoots:
+  m_ObjectHideFlags: 0
+  m_Roots:
+  - {fileID: 320557563}
+  - {fileID: 924544600}
--- a/Assets/Samples/IAAAdDebugSample/Scenes/IAAAdDebugSample.unity.meta
+++ b/Assets/Samples/IAAAdDebugSample/Scenes/IAAAdDebugSample.unity.meta
@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: f2af01c304b689445904b3b93d20ff83
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: