Documentation Index
Fetch the complete documentation index at: https://docs.cloudx.io/llms.txt
Use this file to discover all available pages before exploring further.
插页式广告是在自然过渡点展示的全屏广告。
import { CloudXInterstitialAd } from 'cloudx-react-native';
const AD_UNIT_ID = 'level_complete';
CloudXInterstitialAd.addAdLoadedEventListener((adInfo) => {
console.log('插页式广告已加载,来自', adInfo.networkName);
});
CloudXInterstitialAd.addAdLoadFailedEventListener((error) => {
console.log('插页式广告加载失败:', error.code, error.message);
});
CloudXInterstitialAd.addAdDisplayedEventListener((adInfo) => {
console.log('插页式广告已展示');
});
CloudXInterstitialAd.addAdFailedToDisplayEventListener((error) => {
console.log('插页式广告展示失败:', error.code, error.message);
});
CloudXInterstitialAd.addAdClickedEventListener((adInfo) => {
console.log('插页式广告已点击');
});
CloudXInterstitialAd.addAdHiddenEventListener(() => {
CloudXInterstitialAd.loadAd(AD_UNIT_ID);
});
CloudXInterstitialAd.addAdRevenuePaidListener((adInfo) => {
console.log('收入:', adInfo.revenue);
});
CloudXInterstitialAd.loadAd(AD_UNIT_ID);
const isReady = await CloudXInterstitialAd.isAdReady(AD_UNIT_ID);
if (isReady) {
CloudXInterstitialAd.showAd(AD_UNIT_ID);
// 或传入可选 placement 和 custom data:
// CloudXInterstitialAd.showAd(AD_UNIT_ID, 'level_complete', 'custom_data');
} else {
console.warn('插页式广告尚未准备就绪');
}
// 不再需要时销毁。
CloudXInterstitialAd.destroyAd(AD_UNIT_ID);
React Hook
import { useCloudXInterstitial } from 'cloudx-react-native';
function GameScreen() {
const { isLoaded, isLoading, error, load, show, destroy } =
useCloudXInterstitial('level_complete');
useEffect(() => {
load();
}, [load]);
return (
<Button
title={isLoading ? '加载中...' : '展示广告'}
onPress={() => show()}
disabled={!isLoaded}
/>
);
}
返回:{ isLoaded, isLoading, error, load, show, destroy }
show() 接受可选的 placement 和 customData 参数。
- Hook 在组件卸载时自动销毁广告。