输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
文档管理中心

HarmonyOS

输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
API参考
高级筛选
API version全部版本
设备全部
元服务API集不筛选
您当前正在浏览HarmonyOS最新文档，覆盖已发布的所有API版本，可在API参考中筛选您使用的API版本。详细的版本配套关系请参考版本说明。
API参考应用服务Ads Kit（广告服务）ArkTS组件@ohos.advertising.AutoAdComponent (轮播广告展示组件)

@ohos.advertising.AutoAdComponent (轮播广告展示组件)

Phone12+PC/2in113+Tablet12+
更新时间: 2026-08-29 09:41
本文导读

本模块提供展示轮播广告的能力。

说明

本模块首批接口从API version 11开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

收起
自动换行
深色代码主题
复制
  1. import { AutoAdComponent } from '@kit.AdsKit';

AutoAdComponent

Phone12+PC/2in113+Tablet12+
收起
自动换行
深色代码主题
复制
  1. AutoAdComponent({
  2.   adParam: advertising.AdRequestParams,
  3.   adOptions: advertising.AdOptions,
  4.   displayOptions: advertising.AdDisplayOptions,
  5.   interactionListener: advertising.AdInteractionListener
  6. })

用于展示轮播广告的组件。

装饰器类型：@Component

元服务API： 从API version 12开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Advertising.Ads

参数：

展开
名称 类型 必填 装饰器类型 说明
adParam advertising.AdRequestParams 是 - 广告请求参数。
adOptions advertising.AdOptions 是 - 广告配置参数。
displayOptions advertising.AdDisplayOptions 是 - 广告展示参数。
interactionListener advertising.AdInteractionListener 是 - 广告状态变化回调。

示例：

收起
自动换行
深色代码主题
复制
  1. import { advertising, AutoAdComponent } from '@kit.AdsKit';
  2. import { hilog } from '@kit.PerformanceAnalysisKit';
  3. 

  4. @Entry
  5. @Component
  6. struct Index {
  7.   // 广告请求参数
  8.   private adRequestParams: advertising.AdRequestParams = {
  9.     // 广告位ID
  10.     adId: 'h5xkz3mbr2',
  11.     // 广告类型
  12.     adType: 8,
  13.     // 广告位宽，单位vp
  14.     adWidth: 360,
  15.     // 广告位高，单位vp
  16.     adHeight: 57
  17.   };
  18.   // 广告配置参数
  19.   private adOptions: advertising.AdOptions = {};
  20.   // 广告展示参数
  21.   private adDisplayOptions: advertising.AdDisplayOptions = {
  22.     // 广告轮播的时间间隔，单位ms，取值范围[30000, 120000]
  23.     refreshTime: 30000
  24.   };
  25.   private ratio: number = -1;
  26. 

  27.   aboutToAppear() {
  28.     if (this.adRequestParams.adWidth && this.adRequestParams.adHeight) {
  29.       this.ratio = this.adRequestParams.adWidth / this.adRequestParams.adHeight;
  30.     }
  31.   }
  32.   
  33.   build() {
  34.     Column() {
  35.       AutoAdComponent({
  36.         adParam: this.adRequestParams,
  37.         adOptions: this.adOptions,
  38.         displayOptions: this.adDisplayOptions,
  39.         interactionListener: {
  40.           onStatusChanged: (status: string, ad: advertising.Advertisement, data: string) => {
  41.             switch (status) {
  42.               case 'onAdOpen':
  43.                 hilog.info(0x0000, 'testTag', 'onAdOpen');
  44.                 break;
  45.               case 'onAdClick':
  46.                 hilog.info(0x0000, 'testTag', 'onAdClick');
  47.                 break;
  48.               case 'onAdClose':
  49.                 hilog.info(0x0000, 'testTag', 'onAdClose');
  50.                 break;
  51.             }
  52.           }
  53.         }
  54.       })
  55.         .width('100%')
  56.         .aspectRatio(this.ratio)
  57.     }
  58.     .width('100%')
  59.     .height('100%')
  60.   }
  61. }

build

Phone12+PC/2in113+Tablet12+

build(): void

用于创建AutoAdComponent对象的构造函数。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Advertising.Ads

@ohos.advertising.AdComponent (广告展示组件)
错误码
相关推荐
文档@ohos.advertising.AdComponent (广告展示组件)
文档@ohos.advertising (广告服务框架)
文档Advertisement (请求的广告内容)
文档@ohos.advertising.AdsServiceExtensionAbility (广告扩展服务)
文档@ohos.pluginComponent (PluginComponentManager)
文档@ohos.accessibility (辅助功能)
文档promotionService(营销服务)
文档@ohos.multimedia.avCastPickerParam (投播组件参数)
文档@ohos.multimedia.avCastPicker (投播组件)
文档@ohos.app.ability.EmbeddableUIAbility (可嵌入式UIAbility组件)
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明
在 API参考 中进行搜索
请输入您想要搜索的关键词