Cocos Creator 3.8中使用FBInstant SDK遇Cannot find name错误求助

1. 补充TypeScript类型声明 #

这个错误是因为TS无法识别全局注入的FBInstant模块类型导致的。你可以在项目assets目录下新建types文件夹，创建fb-instant.d.ts文件，写入基础类型声明（可按需扩展）：

declare namespace FBInstant {
  function initializeAsync(): Promise<void>;
  function getPlayer(): Player;
  function getContext(): Context;
  function setLoadingProgress(progress: number): void;
  function startGameAsync(): Promise<void>;

  interface Player {
    getID(): string;
    getName(): string;
    getPhoto(): string;
    getDataAsync(keys: string[]): Promise<{[key: string]: string}>;
    setDataAsync(data: {[key: string]: string}): Promise<void>;
  }

  interface Context {
    getID(): string;
    getType(): string;
  }
}

Creator会自动识别.d.ts文件，TS就能正常识别FBInstant模块并提供类型提示。

2. 快速临时解决 #

如果不需要类型提示，只想快速消除编译错误，可以在使用FBInstant的脚本顶部添加一行声明：

declare const FBInstant: any;

3. 检查构建配置 #

确保你的构建目标是Facebook Instant Games：

• 打开Creator构建面板
• 选择平台为「Facebook Instant Games」
• 确认「集成FBInstant SDK」选项处于勾选状态（Creator 3.8默认勾选）

只有打包成FB小游戏时，Creator才会自动注入SDK，编辑器预览环境无法直接调用，必须打包后在FB小游戏环境测试。

基础使用示例 #

import { _decorator, Component } from 'cc';
const { ccclass } = _decorator;

declare const FBInstant: any; // 或使用完整类型声明

@ccclass('FBGameManager')
export class FBGameManager extends Component {
    async start() {
        // 手动初始化（避免环境差异导致的未初始化问题）
        await FBInstant.initializeAsync();
        // 设置加载完成进度
        FBInstant.setLoadingProgress(100);
        // 启动游戏
        await FBInstant.startGameAsync();
        
        // 获取玩家信息
        const player = FBInstant.getPlayer();
        console.log('玩家ID:', player.getID());
        console.log('玩家昵称:', player.getName());
    }
}

内容的提问来源于stack exchange，提问作者Alex09