mcauthlib 是一个用于在 Flutter 应用程序中处理 Minecraft 认证和授权的库。它主要用于与 Minecraft 账户进行交互，例如验证用户身份、获取访问令牌等。以下是如何在 Flutter 项目中使用 mcauthlib 的基本步骤。

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 mcauthlib 依赖项：

dependencies:
  flutter:
    sdk: flutter
  mcauthlib: ^1.0.0  # 请检查最新版本

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

2. 导入库

在你的 Dart 文件中导入 mcauthlib：

import 'package:mcauthlib/mcauthlib.dart';

3. 初始化认证客户端

创建一个 MinecraftAuthClient 实例来进行认证和授权操作。

final authClient = MinecraftAuthClient(
  clientId: 'YOUR_CLIENT_ID',  // 你的客户端ID
  redirectUri: 'YOUR_REDIRECT_URI',  // 你的重定向URI
);

4. 启动认证流程

使用 authClient 启动认证流程，获取授权码：

final authUrl = authClient.generateAuthUrl(
  scopes: ['profile', 'email'],  // 请求的权限范围
  state: 'some_state',  // 可选的 state 参数
);

// 打开浏览器或 WebView 让用户登录并授权
// 例如使用 url_launcher 插件打开 authUrl

5. 处理回调

用户授权后，Minecraft 会重定向到你的 redirectUri，并附带一个授权码。你需要捕获这个授权码并交换访问令牌：

final authCode = 'AUTHORIZATION_CODE_FROM_REDIRECT';  // 从回调中获取的授权码

final tokenResponse = await authClient.requestToken(
  authCode: authCode,
);

// tokenResponse 包含访问令牌、刷新令牌等信息
print('Access Token: ${tokenResponse.accessToken}');

6. 刷新令牌（可选）

如果访问令牌过期，可以使用刷新令牌来获取新的访问令牌：

final newTokenResponse = await authClient.refreshToken(
  refreshToken: tokenResponse.refreshToken,
);

print('New Access Token: ${newTokenResponse.accessToken}');

7. 获取用户信息（可选）

使用访问令牌可以获取用户的 Minecraft 账户信息：

final userInfo = await authClient.getUserInfo(
  accessToken: tokenResponse.accessToken,
);

print('Username: ${userInfo.username}');
print('Email: ${userInfo.email}');

8. 错误处理

在使用 mcauthlib 时，可能会遇到各种错误，例如网络错误、认证失败等。确保在代码中处理这些错误：

try {
  final tokenResponse = await authClient.requestToken(
    authCode: authCode,
  );
} catch (e) {
  print('Error: $e');
}

9. 示例代码

以下是一个完整的示例代码：

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

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: MinecraftAuthScreen(),
    );
  }
}

class MinecraftAuthScreen extends StatefulWidget {
  [@override](/user/override)
  _MinecraftAuthScreenState createState() => _MinecraftAuthScreenState();
}

class _MinecraftAuthScreenState extends State<MinecraftAuthScreen> {
  final authClient = MinecraftAuthClient(
    clientId: 'YOUR_CLIENT_ID',
    redirectUri: 'YOUR_REDIRECT_URI',
  );

  String _accessToken = '';

  Future<void> _authenticate() async {
    final authUrl = authClient.generateAuthUrl(
      scopes: ['profile', 'email'],
      state: 'some_state',
    );

    // 打开浏览器或 WebView 让用户登录并授权
    // 例如使用 url_launcher 插件打开 authUrl

    // 假设我们从回调中获取了授权码
    final authCode = 'AUTHORIZATION_CODE_FROM_REDIRECT';

    try {
      final tokenResponse = await authClient.requestToken(
        authCode: authCode,
      );

      setState(() {
        _accessToken = tokenResponse.accessToken;
      });

      // 获取用户信息
      final userInfo = await authClient.getUserInfo(
        accessToken: _accessToken,
      );

      print('Username: ${userInfo.username}');
      print('Email: ${userInfo.email}');
    } catch (e) {
      print('Error: $e');
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Minecraft Auth'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            if (_accessToken.isNotEmpty)
              Text('Access Token: $_accessToken')
            else
              ElevatedButton(
                onPressed: _authenticate,
                child: Text('Authenticate with Minecraft'),
              ),
          ],
        ),
      ),
    );
  }
}