@ohos.advertising.AdComponent (非全屏广告展示组件)

本模块提供展示非全屏广告的能力。

说明:

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

导入模块

import { AdComponent } from '@ohos.advertising.AdComponent';

AdComponent

AdComponent(ads: Array<advertising.Advertisement>, displayOptions: advertising.AdDisplayOptions, interactionListener: advertising.AdInteractionListener): void

展示非全屏广告。

系统能力: SystemCapability.Advertising.Ads

起始版本: 11

参数:

参数名 类型 必填 说明
ads Array<advertising.Advertisement> 广告对象数组。
displayOptions advertising.AdDisplayOptions 广告展示参数。
interactionListener advertising.AdInteractionListener 广告状态变化回调。

示例:

import advertising from '@ohos.advertising';
import { AdComponent } from '@ohos.advertising.AdComponent';
import hilog from '@ohos.hilog';

@Entry
@Component
export struct ShowNonFullScreenAd {
  // 请求到的广告内容
  private ads: Array<advertising.Advertisement> = [];
  // 广告展示参数
  private adDisplayOptions: advertising.AdDisplayOptions = {
    // 是否静音,默认不静音
    mute: false,
  }

  build() {
    Column() {
      // AdComponent组件用于展示非全屏广告
      AdComponent({ ads: this.ads, displayOptions: this.adDisplayOptions,
        interactionListener: {
          // 广告状态变化回调
          onStatusChanged: (status: string, ad: advertising.Advertisement, data: string) => {
            switch(status) {
              case 'onAdOpen':
                hilog.info(0x0000, 'testTag', '%{public}s', 'onAdOpen');
                break;
              case 'onAdClick':
                hilog.info(0x0000, 'testTag', '%{public}s', 'onAdClick');
                break;
              case 'onAdClose':
                hilog.info(0x0000, 'testTag', '%{public}s', 'onAdClose');
                break;
            }
          }}})
        .width('100%')
        .height('100%')
    }.width('100%').height('100%')
  }
}