Flutter游戏集成插件fortnite_2的使用

Flutter游戏集成插件fortnite_2的使用

Fortnite 2.0 包

这是一个用于使用非官方Epicgames/Fortnite API的包。该包基于fortnite包。

安装

在你的pubspec.yaml文件中添加以下依赖：

dependencies:
    fortnite_2: any

然后在终端运行以下命令：

dart pub get

如何使用

首先，你需要从一个类似下面的URL获取授权令牌： https://www.epicgames.com/id/api/redirect?clientId=3446cd72694c4a4485d81b77adbb2141&responseType=code

你也可以通过调用Dart中的函数来获取此URL：

getAuthorizationCodeURL();

接下来，你需要创建一个设备认证对象。你可以通过使用从URL中获取的授权码来完成此操作：

deviceAuth = await authenticateWithAuthorizationCode(
  authorizationCode, // 授权码
);

建议将设备认证写入文件或云存储，因为你每次访问玩家特定数据并初始化客户端对象时都需要它。以下是将设备认证写入文件的示例：

final File deviceAuthFile = File("device_auth.json");

await deviceAuthFile.writeAsString(
  JsonEncoder().convert({
    "accountId": deviceAuth.accountId,
    "deviceId": deviceAuth.deviceId,
    "secret": deviceAuth.secret,
    "displayName": deviceAuth.displayName,
  }),
);

从文件读取设备认证的方式如下：

final Map<String, dynamic> deviceAuthDetails = 
  jsonDecode(await deviceAuthFile.readAsString());
deviceAuth = DeviceAuth.fromJson(deviceAuthDetails);

接下来，你需要初始化客户端。可以这样操作：

final Client client = Client(
  options: ClientOptions(
    log: true,
    deviceAuth: deviceAuth,
    logLevel: Level.ALL,
  ),
  overrideSession: "",
)..onSessionUpdate.listen((update) {
    print("Session updated for ${update.accountId}");
    /// 任何你想在会话更新时执行的函数。
});

接下来，初始化客户端配置文件。可用的配置文件列表如下：

• commoncore（购买、VBucks、创作者代码）
• athena（皮肤、与外观相关的物品）
• friends（好友列表、黑名单、添加、删除等）
• events（获取赛季活动及认证用户的锦标赛数据）

你可以通过调用每个配置文件的init()函数来初始化它们：

await client.commonCore.init();

初始化配置文件后，你可以访问其属性，例如好友配置文件的好友列表：

client.friends.friendsList;

使用该包能做些什么

活动

你可以像这样访问活动功能：

client.events.init();
client.events.events;

好友

你可以像这样访问好友功能：

client.friends.init();
client.friends.friendsList;

公共核心

你可以像这样访问公共核心功能：

client.commonCore.init();
client.commonCore.accountId;

阿提娜

你可以像这样访问阿提娜功能：

client.athena.init();
client.athena.gold;

派对

（几乎每个派对功能都需要派对ID，因为我们没有实现Fortnite XMPP，所以我们只能通过获取邀请功能来获取它，因为当有人邀请你时会发送派对ID。目前无法获取你当前所在的派对ID。）

该包还提供了许多STW功能和资源，你可以通过战役配置文件访问它们：

client.campaign.init();
client.campaign.homebase;

示例代码

import "dart:io";
import "dart:convert";
import 'package:fortnite_2/fortnite_2.dart';

final File deviceAuthFile = File("device_auth.json");

// 主函数
void main() async {
  DeviceAuth deviceAuth;

  if (!(await deviceAuthFile.exists())) {
    /// 获取授权码URL
    String authorizationCodeURL = getAuthorizationCodeURL();

    /// 打印URL到控制台
    print("从这里获取授权码: $authorizationCodeURL");

    stdout.write("输入授权码: ");
    String authorizationCode = stdin.readLineSync() ?? "";

    /// 从之前的URL获取授权码并使用它创建设备认证。
    /// 设备认证不会在你强制删除它或更改密码之前失效。
    deviceAuth = await authenticateWithAuthorizationCode(
      authorizationCode, // 授权码
    );

    /// 将设备认证写入文件
    await deviceAuthFile.writeAsString(
      JsonEncoder().convert({
        "accountId": deviceAuth.accountId,
        "deviceId": deviceAuth.deviceId,
        "secret": deviceAuth.secret,
        "displayName": deviceAuth.displayName,
      }),
    );
  }

  /// 从文件读取设备认证
  final Map<String, dynamic> deviceAuthDetails = 
    jsonDecode(await deviceAuthFile.readAsString());

  /// 创建设备对象
  deviceAuth = DeviceAuth.fromJson(deviceAuthDetails);

  /// 创建客户端对象
  final Client client = Client(
    options: ClientOptions(
      log: true,
      deviceAuth: deviceAuth,
      logLevel: Level.ALL,
    ),
    overrideSession: "",
  )..onSessionUpdate.listen((update) {
      print("会话已更新 ${update.accountId}");

      /// 任何你想在会话更新时执行的函数。
    });

  /// 初始化客户端的公共核心配置文件
  await client.commonCore.init();

  /// 打印公共核心配置文件数据中的VBucks
  print("${client.displayName} 你有 ${client.commonCore.totalVbucks} V-Bucks");
}