AdMob Capacitor 插件

使用 @capgo/capacitor-admob

AdMob Plus 插件，用于在 Capacitor 应用中展示 Google AdMob 广告。

安装

bun add @capgo/capacitor-admob
bunx cap sync

bunx cap sync 将插件的原生 code 复制到你的原生项目中。每次升级插件后都要重新运行。

导入

import { AdMob } from '@capgo/capacitor-admob';

API 概览

方法	描述
start	初始化并启动 AdMob SDK。
configure	配置 AdMob 设置。
configRequest	配置广告请求设置。
adCreate	创建一个新的广告实例。
adIsLoaded	检查广告是否已加载并准备好显示。
adLoad	加载广告。
adShow	展示已加载的广告。
adHide	隐藏当前显示的广告。
trackingAuthorizationStatus	获取当前的追踪授权状态 (仅限 iOS)。
requestTrackingAuthorization	向用户请求追踪授权 (仅限 iOS)。

示例

start()

初始化并启动 AdMob SDK。

import { AdMob } from '@capgo/capacitor-admob';

await AdMob.start();

configure()

配置 AdMob 设置。

import { AdMob } from '@capgo/capacitor-admob';

await AdMob.configure({
  appMuted: false,
  appVolume: 0.5
});

configRequest()

配置广告请求设置。

import { AdMob, MaxAdContentRating } from '@capgo/capacitor-admob';

await AdMob.configRequest({
  maxAdContentRating: MaxAdContentRating.PG,
  tagForChildDirectedTreatment: true,
  testDeviceIds: ['test-device-id']
});

adCreate()

创建一个新的广告实例。

import { AdMob } from '@capgo/capacitor-admob';

await AdMob.adCreate({
  adUnitId: 'ca-app-pub-3940256099942544/1033173712'
});

adIsLoaded()

检查广告是否已加载并准备好显示。

import { AdMob } from '@capgo/capacitor-admob';

const isLoaded = await AdMob.adIsLoaded({ id: 1 });
if (isLoaded) {
  await AdMob.adShow({ id: 1 });
}

adLoad()

加载广告。

import { AdMob } from '@capgo/capacitor-admob';

await AdMob.adLoad({ id: 1 });

上表列出了 10 个核心方法。监听器、版本辅助函数以及每个方法的完整接口定义，请参阅 GitHub 仓库.

监听事件

addListener 会返回一个句柄。调用 handle.remove() 当屏幕卸载时。

完整参考文档

• GitHub 仓库
• 文档
• API 参考文档

从“使用 @capgo/capacitor-admob”继续

如果你正在使用 使用 @capgo/capacitor-admob 要规划原生插件工作，请将其与 @capgo/capacitor-admob 有关 @capgo/capacitor-admob 的实现细节， 快速入门 有关“入门指南”中的实现细节， Capgo 插件目录 查看 Capgo 插件目录中的产品工作流， Capgo 提供的 Capacitor 插件 有关 Capgo 开发的 Capacitor 插件的实现细节，以及 添加或更新插件 有关添加或更新插件的实现细节。