# flutter_ads_hx

**Repository Path**: hx-sdk-android/flutter_ads_hx

## Basic Information

- **Project Name**: flutter_ads_hx
- **Description**: 彗星Flutter SDK
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-22
- **Last Updated**: 2025-12-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# flutter_ads_hx

☄️ 彗星广告 Flutter 插件

## 安装


1. 添加依赖

```yaml
dependencies:
  flutter_ads_hx:
    git:
      url: https://gitee.com/hx-sdk-android/flutter_ads_hx.git
      ref: 1.1.1
```

2. 导入插件

```dart
import 'package:flutter_ads_hx/flutter_ads_hx.dart';
```

## 初始化

1. 初始化广告

```dart
final _flutterAdsHx = FlutterAdsHx();
// 初始化广告
await _flutterAdsHx.initHxAd("your_app_id");
```
2. 设置监听

```dart
// 设置监听
await _flutterAdsHx.onEventListener((event) {
  print("onEventListener: $event");
});
```

## 加载广告

1. 加载广告

```dart
// 加载广告
final int? adId = await _flutterAdsHx.loadHxIconAd(
    "your_pos_id",
    width: 28,
    height: 28,
);
// 如果 adId 为 null，则加载失败，不为空则加载成功
if (adId == null) {
  print("loadHxIconAd failed");
  return;
}
```
2. 清除广告
```dart
// 清除广告，一定要传递 adId，一般不需要调用，可以在页面关闭的时候调用
await _flutterAdsHx.clearHxIconAd(adId!);
```

## 显示广告

```dart
// 显示广告，一定要设置 key
AdHxIconWidget(
    key: Key("ad_hx_icon_$adId"),
    posId: adId!, // 这里是 adId ,不要传递 posId
    width: 28,
    height: 28,
)
```

## 混淆配置

``` java
// 混淆配置
-dontwarn com.hxad.sdk.**
-keep class com.hxad.sdk.**{*;}
```



## 附件

1、广告事件状态对应列表

| 状态 | 说明 |
| --- | --- |
| HxAdEventAction.onAdLoaded | 广告加载成功 |
| HxAdEventAction.onAdError | 广告加载失败 |
| HxAdEventAction.onAdExposure | 广告曝光 |
| HxAdEventAction.onAdClicked | 广告点击 |
| HxAdEventAction.onAdClosed | 广告关闭|