初始化 SDK

在 App 启动时尽早初始化一次（如 main() 或首页 initState）。必须在创建任何广告之前完成。

初始化是回调式（对齐原生 SDK）：onComplete(success) 在初始化真正完成（UA/IDFA 预热结束）时于主 isolate 触发，true 表示成功。可在构造时通过可选的 userContext 直接带入用户定向上下文（等价于紧接着调用 setUserContext）。

main() / App 启动
        ↓
NovvyAds.initialize(appId, endpoint, apiKey, userContext?, onComplete)
        ↓
onComplete(success)                  // 初始化完成（UA/IDFA 预热后）
        ↓
NovvyAds.setContentContext(...)      // 短剧场景：每次 load/attach 前设置

NovvyAds.initialize(
  appId: 'your_app_id',
  endpoint: 'https://bid.novvy.ai',
  apiKey: 'your_api_key',
  userContext: NovvyUserContext(userId: 'user_123'),   // 可选：用户定向上下文，也可初始化后再设置
  onComplete: (success) {                              // 可选：初始化完成回调
    if (!success) log('Novvy 初始化失败');
  },
);

参数说明

NovvyAds.initialize 参数（平铺，对齐原生 SDK）：

参数	类型	说明
appId	String	必填，应用标识
endpoint	String	必填，广告服务地址
apiKey	String	必填，密钥，随请求发送用于鉴权
userContext	NovvyUserContext?	可选，初始化时带入的用户定向上下文（映射原生 initialize(userContext:)），见用户与内容上下文
onComplete	void Function(bool success)?	可选，初始化完成回调；false = 初始化失败或平台调用出错。主 isolate 触发

initialize() 可再次调用（如登录/登出后）以刷新配置，原生 SDK 幂等处理重复初始化。凭证变化时可再次调用。