Flutter Riot API集成插件riot_api的使用

Flutter Riot API集成插件riot_api的使用

简介

riot_api 插件为Dart语言提供了一种简单的方法来使用Riot账户API。如果你需要使用《英雄联盟》API，请访问其他相关包。

支持的API

• Riot账户API
  • ACCOUNT-V1

环境要求

要使用此Dart SDK，你需要：

• Dart 2.19.0或更高版本

示例代码

1. 生成Riot API密钥

首先，你需要在Riot Games开发者门户生成一个API密钥。

2. 初始化RiotApi

使用你的API密钥初始化 RiotApi：

import 'package:riot_api/riot_api.dart';

void main() async {
  // 初始化RiotApi
  await RiotApi.init(apiKey: 'your-api-key');
  
  // 你可以在这里开始调用API
}

3. 获取账户信息

通过PUUID获取账户信息

import 'package:riot_api/riot_api.dart';
import 'package:riot_api/src/models/account_v1/account.dart';
import 'package:riot_api/src/models/platform_values.dart';

void main() async {
  // 初始化RiotApi
  await RiotApi.init(apiKey: 'your-api-key');

  const puuid = 'your-puuid';

  try {
    // 通过PUUID获取账户信息
    final user = await AccountV1.getAccountByPuuid(PlatformValues.asia, puuid);
    print('Account information by PUUID: $user');
  } catch (e) {
    print('Error fetching account by PUUID: $e');
  }
}

通过游戏名称和标签行获取账户信息

import 'package:riot_api/riot_api.dart';
import 'package:riot_api/src/models/account_v1/account.dart';
import 'package:riot_api/src/models/platform_values.dart';

void main() async {
  // 初始化RiotApi
  await RiotApi.init(apiKey: 'your-api-key');

  const gameName = 'your-game-name';
  const tagLine = 'your-tag-line';

  try {
    // 通过游戏名称和标签行获取账户信息
    final user2 = await AccountV1.getAccountByRiotId(PlatformValues.asia, gameName, tagLine);
    print('Account information by Riot ID: $user2');
  } catch (e) {
    print('Error fetching account by Riot ID: $e');
  }
}

其他Riot API包

我们还提供了其他Riot API包：

• lol_api：用于《英雄联盟》API
• val_api：用于《Valorant》API
• tft_api：用于《云顶之弈》API
• lor_api：暂不支持

如何贡献

如果你想为这个仓库贡献代码，请参考仓库的贡献指南。

完整示例Demo

以下是一个完整的Flutter应用示例，展示了如何集成 riot_api 插件并调用Riot账户API。

项目结构

lib/
├── main.dart
└── services/
    └── riot_service.dart

main.dart

import 'package:flutter/material.dart';
import 'package:riot_api/riot_api.dart';
import 'services/riot_service.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  // 初始化RiotApi
  await RiotApi.init(apiKey: 'your-api-key');
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Riot API Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: HomeScreen(),
    );
  }
}

class HomeScreen extends StatefulWidget {
  @override
  _HomeScreenState createState() => _HomeScreenState();
}

class _HomeScreenState extends State<HomeScreen> {
  final RiotService _riotService = RiotService();
  String _accountInfo = '';

  Future<void> _fetchAccountInfoByPuuid() async {
    try {
      final user = await _riotService.getAccountByPuuid('your-puuid');
      setState(() {
        _accountInfo = user.toString();
      });
    } catch (e) {
      setState(() {
        _accountInfo = 'Error: $e';
      });
    }
  }

  Future<void> _fetchAccountInfoByRiotId() async {
    try {
      final user = await _riotService.getAccountByRiotId('your-game-name', 'your-tag-line');
      setState(() {
        _accountInfo = user.toString();
      });
    } catch (e) {
      setState(() {
        _accountInfo = 'Error: $e';
      });
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Riot API Demo'),
      ),
      body: Padding(
        padding: EdgeInsets.all(16.0),
        child: Column(
          children: [
            ElevatedButton(
              onPressed: _fetchAccountInfoByPuuid,
              child: Text('Fetch Account by PUUID'),
            ),
            SizedBox(height: 16.0),
            ElevatedButton(
              onPressed: _fetchAccountInfoByRiotId,
              child: Text('Fetch Account by Riot ID'),
            ),
            SizedBox(height: 16.0),
            Text(_accountInfo),
          ],
        ),
      ),
    );
  }
}

services/riot_service.dart

import 'package:riot_api/riot_api.dart';
import 'package:riot_api/src/models/account_v1/account.dart';
import 'package:riot_api/src/models/platform_values.dart';

class RiotService {
  Future<Account> getAccountByPuuid(String puuid) async {
    return await AccountV1.getAccountByPuuid(PlatformValues.asia, puuid);
  }

  Future<Account> getAccountByRiotId(String gameName, String tagLine) async {
    return await AccountV1.getAccountByRiotId(PlatformValues.asia, gameName, tagLine);
  }
}