智能客服
你问我答，随时在线为你解决问题
本模块首批接口从API version 11开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
- 探索了解鸿蒙应用和多设备开发，学习如何构建应用/元服务应用形态HarmonyOS 应用One as All，All as One
元服务秒开直达 服务随行 无处不在
游戏为游戏创意玩法带来无限可能
多设备应用开发穿戴
折叠屏手机鸿蒙电脑开发者学堂视频课程Codelabs - 设计了解鸿蒙应用和多设备开发，学习如何构建应用/元服务
- 开发获取官方开发工具和文档等资源，将创意转化为鸿蒙应用开发工具DevEco Studio应用开发 IDE, AI Agent 和 CLI
小艺开放平台Skill 和智能体开发平台
ArkTS
ArKUI
AppGallery ConnectDevEco Testing开发资源工具下载示例代码开发文档最佳实践 - 分发通过华为应用市场发布你的应用，多渠道触达用户应用分发应用市场纯净安全的全场景应用分发平台
游戏中心
应用审核政策服务分发小艺HarmonyOS 的超级 AI 入口
智慧助手·今天
服务分发文档内容分发主题服务
内容分发文档 - 推广与变现一站式流量增长与营销变现平台推广应用推广引擎全链路应用推广与增长服务平台
鲸鸿动能广告为企业广告主提供广告营销服务
联运服务推广文档变现鲸鸿动能流量变现使能应用展示广告，实现流量变现应用内支付变现文档 - 生态合作携手伙伴共建共享鸿蒙智能终端生态伙伴 SDK一站式获取安全可靠的鸿蒙伙伴 SDK
生态服务鸿蒙应用开发、培训和人力服务
服务商伙伴中心华为终端云服务商伙伴的统一门户
伙伴入驻指南生态市场介绍，卖家和买家服务指引
廉洁政策合作伙伴诚信廉洁政策
- 支持获取客服帮助、技术支持、活动资讯等信息智能客服24小时 AI 在线自助服务，即问即答
社区问答在官方论坛提问，与开发者互动交流
在线提单提交工单，获得技术支持
开发者活动HDD 等线下活动速览及报名入口
资讯帮助指南
全部文档
指南
API
开放能力API
高级筛选
API version全部版本
设备全部
元服务API集不筛选
API参考概述
应用框架
系统
媒体
图形
应用服务
AI
公共基础能力
标准库
您当前正在浏览HarmonyOS最新文档，覆盖已发布的所有API版本，可在API参考中筛选您使用的API版本。详细的版本配套关系请参考版本说明。
@ohos.advertising.AutoAdComponent (轮播广告展示组件)
Phone12+PC/2in113+Tablet12+
更新时间: 2026-08-29 09:41
本模块提供展示轮播广告的能力。
说明
导入模块
import { AutoAdComponent } from '@kit.AdsKit'; AutoAdComponent
Phone12+PC/2in113+Tablet12+
AutoAdComponent({
adParam: advertising.AdRequestParams,
adOptions: advertising.AdOptions,
displayOptions: advertising.AdDisplayOptions,
interactionListener: advertising.AdInteractionListener
}) 用于展示轮播广告的组件。
装饰器类型：@Component
元服务API： 从API version 12开始，该接口支持在元服务中使用。
系统能力： SystemCapability.Advertising.Ads
参数：
展开
| 名称 | 类型 | 必填 | 装饰器类型 | 说明 |
|---|---|---|---|---|
| adParam | advertising.AdRequestParams | 是 | - | 广告请求参数。 |
| adOptions | advertising.AdOptions | 是 | - | 广告配置参数。 |
| displayOptions | advertising.AdDisplayOptions | 是 | - | 广告展示参数。 |
| interactionListener | advertising.AdInteractionListener | 是 | - | 广告状态变化回调。 |
示例：
import { advertising, AutoAdComponent } from '@kit.AdsKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
@Entry
@Component
struct Index {
// 广告请求参数
private adRequestParams: advertising.AdRequestParams = {
// 广告位ID
adId: 'h5xkz3mbr2',
// 广告类型
adType: 8,
// 广告位宽，单位vp
adWidth: 360,
// 广告位高，单位vp
adHeight: 57
};
// 广告配置参数
private adOptions: advertising.AdOptions = {};
// 广告展示参数
private adDisplayOptions: advertising.AdDisplayOptions = {
// 广告轮播的时间间隔，单位ms，取值范围[30000, 120000]
refreshTime: 30000
};
private ratio: number = -1;
aboutToAppear() {
if (this.adRequestParams.adWidth && this.adRequestParams.adHeight) {
this.ratio = this.adRequestParams.adWidth / this.adRequestParams.adHeight;
}
}
build() {
Column() {
AutoAdComponent({
adParam: this.adRequestParams,
adOptions: this.adOptions,
displayOptions: this.adDisplayOptions,
interactionListener: {
onStatusChanged: (status: string, ad: advertising.Advertisement, data: string) => {
switch (status) {
case 'onAdOpen':
hilog.info(0x0000, 'testTag', 'onAdOpen');
break;
case 'onAdClick':
hilog.info(0x0000, 'testTag', 'onAdClick');
break;
case 'onAdClose':
hilog.info(0x0000, 'testTag', 'onAdClose');
break;
}
}
}
})
.width('100%')
.aspectRatio(this.ratio)
}
.width('100%')
.height('100%')
}
} build
Phone12+PC/2in113+Tablet12+
build(): void
用于创建AutoAdComponent对象的构造函数。
元服务API： 从API version 12开始，该接口支持在元服务中使用。
系统能力： SystemCapability.Advertising.Ads
华为开发者联盟 版权所有 ©2026
在 开发与测试 开放能力API 中进行搜索
请输入您想要搜索的关键词