实现广告服务

目录

• 简介
• 使用说明
• 工程目录
• 相关权限
• 约束与限制

简介

鲸鸿动能广告服务HarmonyOS ArkTs示例代码向您介绍如何在应用中使用将鲸鸿动能API并实现广告展示。

使用说明

运行本示例前需要参考指导配置应用签名信息。

工程目录

├─AppScope                               // 应用全局配置目录
│ ├─resources                            // 应用全局资源目录
│ └─app.json5                           // 应用配置文件
├─entry                                 // 主模块目录
│ ├─build                               // 构建输出目录
│ ├─src                                 // 源代码目录
│ │ ├─main                              // 主代码目录
│ │ │ ├─ets                             // 代码区
│ │ │ │ ├─entryability                  // 入口能力目录
│ │ │ │ │ └─EntryAbility.ets           // 主程序入口类
│ │ │ │ └─pages                        // 存放页面文件目录
│ │ │ │   ├─Index.ets                 // 应用主页面
│ │ │ │   ├─guide                     // 广告指南页面目录
│ │ │ │   │ ├─banner                 // 横幅广告
│ │ │ │   │ │ └─LoadAd.ets         // 横幅广告加载页面
│ │ │ │   │ ├─native                 // 原生广告
│ │ │ │   │ │ └─LoadAd.ets         // 原生广告加载页面
│ │ │ │   │ ├─reward                 // 激励广告
│ │ │ │   │ │ ├─LoadAd.ets         // 激励广告加载页面
│ │ │ │   │ │ └─RewardAdStatusHandler.ets  // 激励广告事件订阅类
│ │ │ │   │ ├─interstitial           // 插屏广告
│ │ │ │   │ │ ├─LoadAd.ets         // 插屏广告加载页面
│ │ │ │   │ │ └─InterstitialAdStatusHandler.ets  // 插屏广告事件订阅类
│ │ │ │   │ ├─roll                   // 贴片广告
│ │ │ │   │ │ └─LoadAd.ets         // 贴片广告加载页面
│ │ │ │   │ ├─splash                 // 开屏广告
│ │ │ │   │ │ └─LoadAd.ets         // 开屏广告加载页面
│ │ │ │   │ ├─bidding               // 竞价广告
│ │ │ │   │ │ ├─Step1.ets          // 竞价广告第一步
│ │ │ │   │ │ └─Step2.ets          // 竞价广告第二步
│ │ │ │   │ └─oaid                 // OAID相关
│ │ │ │   │   ├─GetOAID.ets        // 获取OAID
│ │ │ │   │   └─ResetOAID.ets      // 重置OAID
│ │ │ │   └─references              // 引用目录
│ │ │ │     ├─api                   // API接口目录
│ │ │ │     │ ├─advertising         // 广告API
│ │ │ │     │ └─identifier         // 标识符API
│ │ │ │     └─component             // 组件目录
│ │ │ │       ├─AdComponent.ets     // 广告组件
│ │ │ │       └─AutoAdComponent.ets // 自动广告组件
│ │ │ ├─resources                    // 资源文件目录
│ │ │ │ ├─base                      // 基础资源目录
│ │ │ │ │ ├─element                // 元素资源
│ │ │ │ │ │ ├─color.json          // 颜色配置文件
│ │ │ │ │ │ ├─float.json          // 浮点数配置文件
│ │ │ │ │ │ └─string.json        // 字符串配置文件
│ │ │ │ │ ├─media                  // 媒体资源目录
│ │ │ │ │ │ ├─background.png       // 背景图片
│ │ │ │ │ │ ├─foreground.png       // 前景图片
│ │ │ │ │ │ ├─startIcon.png       // 启动图标
│ │ │ │ │ │ ├─slogan.png          // 标语图片
│ │ │ │ │ │ ├─video.png           // 视频图标
│ │ │ │ │ │ ├─video_preview.png    // 视频预览图
│ │ │ │ │ │ └─layered_image.json // 分层图片配置
│ │ │ │ │ └─profile               // 配置文件目录
│ │ │ │ │   └─main_pages.json    // 主页面配置文件
│ │ │ │ ├─dark                     // 暗色主题资源目录
│ │ │ │ │ └─element              // 暗色主题元素资源
│ │ │ │ └─rawfile                // 原始文件资源目录
│ │ │ │   └─videoTest.mp4       // 视频测试文件
│ │ │ └─module.json5             // 模块配置文件
│ ├─build-profile.json5            // 模块构建配置文件
│ ├─hvigorfile.ts                 // 模块构建脚本文件
│ ├─oh-package.json5              // 模块包管理配置文件
│ └─obfuscation-rules.txt        // 混淆规则文件
├─hvigor                           // 构建工具目录
│ └─hvigor-config.json5           // 构建工具配置文件
├─build-profile.json5              // 构建配置文件
├─hvigorfile.ts                   // 构建脚本文件
├─code-linter.json5              // 代码检查配置文件
├─import-sorter.json             // 导入排序配置文件
├─oh-package.json5                // 包管理配置文件
├─readme_cn.md                   // 中文说明文档
└─readme_en.md                   // 英文说明文档

相关权限

• 获取开放匿名设备标识符需要申请跨应用关联权限：ohos.permission.APP_TRACKING_CONSENT。
• 请求展示广告需要申请Internet网络权限：ohos.permission.INTERNET。

约束与限制

1. 本示例仅支持标准系统上运行，支持设备：华为手机、平板设备、PC/2in1。
2. HarmonyOS系统：HarmonyOS 5.0.5 Release及以上。
3. DevEco Studio版本：DevEco Studio 6.0.0 Release及以上。
4. HarmonyOS SDK版本：HarmonyOS 6.0.0 Release SDK及以上。