🚀 快速开始

穿山甲内容 SDK 依赖 GroMore 广告插件（gromore_ads）。本页仅说明初始化流程，请务必在广告 SDK 完成初始化后再启动内容 SDK。

前置条件

完成安装与配置中的所有步骤。
确保 gromore_ads 插件已按安装文档准备配置文件。

初始化顺序

调用 GromoreAds.initAd 完成 GroMore 广告 SDK 初始化。
调用 PangrowthContent.initialize 读取内容配置文件。
在广告 SDK 返回成功后调用 PangrowthContent.start 启动内容模块。

初始化示例

import 'package:flutter/foundation.dart';
import 'package:flutter/widgets.dart';
import 'package:gromore_ads/gromore_ads.dart';
import 'package:pangrowth_content/pangrowth_content.dart';

Future<void> bootstrapContentSdk() async {
  // 1. 先初始化 GroMore 广告 SDK（内容 SDK 依赖它）
  final adsReady = await GromoreAds.initAd(
    'your_gromore_app_id',
    useMediation: true,
    debugMode: kDebugMode,
  );
  if (!adsReady) {
    debugPrint('GroMore 广告 SDK 初始化失败');
    return;
  }

  // 2. 加载内容配置，准备短剧/故事/视频模块
  final initialized = await PangrowthContent.initialize(
    configPath: 'SDK_Setting_5609594.json',
    config: const ContentConfig(
      enableDrama: true,
      enableStory: false,
      enableVideo: true,
      debugLog: kDebugMode,
    ),
  );
  if (!initialized) {
    debugPrint('穿山甲内容 SDK 初始化失败');
    return;
  }

  // 3. 等广告 SDK 准备就绪后启动内容服务
  await PangrowthContent.start();
}

确保 configPath 指向安装文档准备好的 SDK_Setting_XXXXXXX.json（Flutter 资源或平台特定位置），并在广告 SDK 初始化成功后再调用 PangrowthContent.start。完成上述步骤后即可继续阅读其他接口文档。

调用节奏建议

初始化前置：PangrowthContent.initialize 负责加载配置与启动前准备，可在 App 启动阶段（如 Splash、登录前）提前执行，降低后续等待时间。
启动延后：PangrowthContent.start 依赖 GroMore 广告 SDK 已完成初始化，建议在用户完成隐私授权、GroMore 返回成功等关键节点后再调用，避免资源未就绪或请求失败。
链路示例：App 启动 → 提前调用 initialize → 等待 GroMore 初始化与业务条件满足 → 调用 start → 渲染短剧/故事/小视频场景。