game_center_helper 是一个用于在 Flutter 应用中集成 Apple Game Center 的插件。它允许你访问 Game Center 的功能，如登录、排行榜、成就等。以下是如何使用 game_center_helper 插件的基本步骤：

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 game_center_helper 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  game_center_helper: ^0.1.0 # 请检查最新版本

然后运行 flutter pub get 来安装依赖。

2. 配置 iOS 项目

确保你的 iOS 项目已经启用了 Game Center 功能。打开 ios/Runner.xcworkspace 在 Xcode 中，然后：

1. 选择 Runner 项目。
2. 选择 Runner 目标。
3. 在 Signing & Capabilities 选项卡中，点击 + Capability 按钮。
4. 添加 Game Center 功能。

3. 初始化 Game Center

在你的 Flutter 代码中，首先需要初始化 Game Center。通常在 main.dart 文件中进行初始化：

import 'package:flutter/material.dart';
import 'package:game_center_helper/game_center_helper.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await GameCenterHelper.initialize();
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Game Center Demo',
      home: GameCenterDemo(),
    );
  }
}

4. 登录 Game Center

在使用 Game Center 功能之前，用户需要登录 Game Center。你可以使用 GameCenterHelper.authenticate() 方法来要求用户登录：

class GameCenterDemo extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Game Center Demo'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () async {
            bool isAuthenticated = await GameCenterHelper.authenticate();
            if (isAuthenticated) {
              print('User is authenticated with Game Center');
            } else {
              print('User is not authenticated with Game Center');
            }
          },
          child: Text('Authenticate with Game Center'),
        ),
      ),
    );
  }
}

5. 提交分数到排行榜

你可以使用 GameCenterHelper.submitScore() 方法将玩家的分数提交到指定的排行榜：

void submitScore() async {
  bool success = await GameCenterHelper.submitScore(
    leaderboardID: 'your_leaderboard_id', // 替换为你的排行榜ID
    value: 1000, // 分数值
  );
  if (success) {
    print('Score submitted successfully');
  } else {
    print('Failed to submit score');
  }
}

6. 提交成就

你可以使用 GameCenterHelper.unlockAchievement() 方法来解锁成就：

void unlockAchievement() async {
  bool success = await GameCenterHelper.unlockAchievement(
    achievementID: 'your_achievement_id', // 替换为你的成就ID
    percentComplete: 100.0, // 成就完成百分比
  );
  if (success) {
    print('Achievement unlocked successfully');
  } else {
    print('Failed to unlock achievement');
  }
}

7. 显示 Game Center 视图

你可以使用 GameCenterHelper.showLeaderboards() 和 GameCenterHelper.showAchievements() 方法来显示 Game Center 的排行榜和成就视图：

void showLeaderboards() async {
  bool success = await GameCenterHelper.showLeaderboards();
  if (success) {
    print('Leaderboards shown successfully');
  } else {
    print('Failed to show leaderboards');
  }
}

void showAchievements() async {
  bool success = await GameCenterHelper.showAchievements();
  if (success) {
    print('Achievements shown successfully');
  } else {
    print('Failed to show achievements');
  }
}

8. 处理错误

在使用 game_center_helper 时，可能会遇到各种错误。你可以通过捕获异常来处理这些错误：

void submitScoreWithErrorHandling() async {
  try {
    bool success = await GameCenterHelper.submitScore(
      leaderboardID: 'your_leaderboard_id',
      value: 1000,
    );
    if (success) {
      print('Score submitted successfully');
    } else {
      print('Failed to submit score');
    }
  } catch (e) {
    print('An error occurred: $e');
  }
}