SDK文档 - 指天椒互娱

🚀 功能特性

🎯 激励视频广告

📺 全屏视频广告

🖼️ 半屏视频广告

📍 贴片广告

🎮 更多游戏

📋 隐私政策

🔄 场景广告

⚙️ 集成方法

1. 添加AAR依赖

将生成的 htads.aar 文件添加到你的Android项目中：

// 在app模块的build.gradle中添加
dependencies {
    implementation files('libs/htads.aar')
}

2. 创建AdsListener

用来接收激励视频回调结果：

package com.ht.adsdk.ya;

import java.util.ArrayList;

public class AdsListener {

    public static void showRewardVideoComplete(ArrayList<Object> arrayList) {
        if (arrayList == null || arrayList.size() <= 0) {
            return;
        }
        int intValue = ((Integer) arrayList.get(0)).intValue();
        if (intValue == 1) {
            // 激励视频播放完成
        }
    }

    public static void showRewardVideoFailure(ArrayList<Object> arrayList) {
        if (arrayList == null || arrayList.size() <= 0) {
            return;
        }
        int intValue = ((Integer) arrayList.get(0)).intValue();
        if (intValue == 1) {
            // 激励视频播放失败
        }
    }
}

📚 API 使用说明

激励视频广告

import com.ht.adsdk.ya.Ads;
import java.util.ArrayList;

// 显示激励视频广告
ArrayList<Object> arrayList = new ArrayList<>();
arrayList.add(1); // 自定义参数和AdsListener对应
Ads.showRewardVideo(arrayList);

回调说明：

• 播放成功：调用 AdsListener.showRewardVideoComplete()
• 播放失败：调用 AdsListener.showRewardVideoFailure()

场景广告

// 触发场景广告
Ads.triggerScene("4"); // 关卡结束

场景说明：

4关卡结束

6游戏重开

9游戏暂停

11升级

13场景切换

15按钮设置

其他功能

// 显示更多游戏
Ads.showMoreGames();

// 显示隐私政策
Ads.showPrivacyPolicy();

// 显示全屏视频广告
Ads.showFullVideo();

// 显示半屏视频广告
Ads.showInsert();

贴片广告

import com.ht.adsdk.core.model.Position;

// 创建广告位置
Position position = new Position("center", "center", 100, 100);

// 显示贴片广告
Ads.showPatchAd(position, true);

// 关闭贴片广告
Ads.closePatchAd();

// 设置贴片广告内容
Ads.setupPatchTitleContent("广告标题", "广告内容");

Position 参数说明：

pos位置标识

align对齐方式

marginTop上边距(像素)

marginLeft左边距(像素)

🔧 调试与注意事项

日志调试

SDK使用 HTLog 类进行日志输出，标签为 HT_AD_HTLog：

# 在logcat中查看日志
adb logcat | grep "HT_AD_"

注意事项：

• Unity Activity获取：SDK会自动获取Unity的当前Activity，确保在Unity环境中使用
• 确保在主线程中调用SDK方法
• 建议在游戏初始化完成后再调用广告相关接口
• 测试时请使用测试环境，避免影响正式数据

广告SDK文档