C# WPF从RIOT API获取数据(RIOT代表作品《英雄联盟》)

阅读导航

  1. 本文背景
  2. 代码实现
  3. 本文参考

1. 本文背景

RIOT(拳头)是一家美国网游开发商,成立于2006年,代表作品《英雄联盟》。

本文重点要讲解两个知识点:

  1. C# 使用 HttpClient 访问 RIOT 提供的 API 接口,获取召唤者概况信息;
  2. C# WPF界面展示召唤者信息搜索、概况信息两个界面。
RIOT API访问数据展示

2. 代码实现

站长使用 .Net CORE 3.1 创建名为 “LoLGoal” 的WPF解决方案,并添加3个Nuget包,配置如下:

<?xml version="1.0" encoding="utf-8"?>
<packages>
  <package id="MaterialDesignColors" version="1.1.1" targetFramework="net45" />
  <package id="MaterialDesignThemes" version="2.5.0.1205" targetFramework="net45" />
  <package id="Newtonsoft.Json" version="12.0.1" targetFramework="net45" />
</packages>

界面使用的MD控件,本站曾有介绍:介绍 。

本文只简单说明部分代码,整体解决方案目录结构如下,源码文末会给出:

目录结构

2.1 引入MD控件样式

文件【App.xaml】

<Application x:Class="LoLGoal.App"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             StartupUri="View/MainWindow.xaml">
    <Application.Resources>
        <ResourceDictionary>
            <ResourceDictionary.MergedDictionaries>
                <ResourceDictionary Source="pack://application:,,,/MaterialDesignThemes.Wpf;component/Themes/MaterialDesignTheme.Light.xaml" />
                <ResourceDictionary Source="pack://application:,,,/MaterialDesignThemes.Wpf;component/Themes/MaterialDesignTheme.Defaults.xaml" />
                <ResourceDictionary Source="pack://application:,,,/MaterialDesignColors;component/Themes/Recommended/Primary/MaterialDesignColor.Purple.xaml" />
                <ResourceDictionary Source="pack://application:,,,/MaterialDesignColors;component/Themes/Recommended/Accent/MaterialDesignColor.Blue.xaml" />
            </ResourceDictionary.MergedDictionaries>
        </ResourceDictionary>
    </Application.Resources>
</Application>

2.2 召唤者概况搜索界面

文件【MainWindow.xaml】代码,界面布局简单,给人的感觉整体简洁大方:

<Window x:Class="LoLGoal.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:materialDesign="http://materialdesigninxaml.net/winfx/xaml/themes"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        mc:Ignorable="d" Height="600" Width="400" WindowStartupLocation="CenterScreen" 
        MouseLeftButtonDown="Window_MouseLeftButtonDown"
        ResizeMode="NoResize" WindowStyle="None" Background="#FF410A66">
    <Grid>
        <StackPanel Margin="50">
            <Image Source="/Assets/logo2.png" Width="96" Height="96"/>
            <Border Background="White" Margin="10 20" CornerRadius="5">
                <StackPanel Margin="25">
                    <ComboBox Margin="15" Style="{StaticResource MaterialDesignFloatingHintComboBox}" materialDesign:HintAssist.Hint="地区" Text="{Binding Region}">
                        <ComboBoxItem Content="RU"/>
                        <ComboBoxItem Content="KR"/>
                        <ComboBoxItem Content="BR1"/>
                        <ComboBoxItem Content="OC1"/>
                        <ComboBoxItem Content="JP1"/>
                        <ComboBoxItem Content="NA1"/>
                        <ComboBoxItem Content="EUN1"/>
                        <ComboBoxItem Content="EUW1"/>
                        <ComboBoxItem Content="TR1"/>
                        <ComboBoxItem Content="LA1"/>
                        <ComboBoxItem Content="LA2"/>
                    </ComboBox>
                    <TextBox Text="{Binding SummonerName}" Margin="15" Style="{StaticResource MaterialDesignFloatingHintTextBox}" materialDesign:HintAssist.Hint="召唤者"/>
                    <StackPanel Orientation="Horizontal" HorizontalAlignment="Center">
                        <Button Margin="15 50" Content="取消"/>
                        <Button x:Name="ButtonSignUp" Margin="15 50" Content="搜索" Click="ButtonSignUp_Click"/>
                    </StackPanel>
                </StackPanel>
            </Border>
        </StackPanel>
    </Grid>
</Window>

召唤者概况搜索界面

召唤者概况搜索界面

2.3 召唤者概况信息展示界面

文件【WindowProfile.xaml】,布局代码也不多,清爽:

<Window x:Class="LoLGoal.View.WindowProfile"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:materialDesign="http://materialdesigninxaml.net/winfx/xaml/themes"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        mc:Ignorable="d" Height="600" Width="400" 
        WindowStartupLocation="CenterScreen" ResizeMode="NoResize" 
        WindowStyle="None" Background="#FF410A66">
    <Grid>
        <Border Background="White" Margin="20 100 20 20" CornerRadius="15">
            <StackPanel VerticalAlignment="Top" HorizontalAlignment="Stretch">
                <Border Width="100" Height="100" Margin="20 20 0 10" BorderBrush="Gray" HorizontalAlignment="Left" BorderThickness="1" CornerRadius="15">
                    <Border.Background>
                        <ImageBrush ImageSource="{Binding Path=Icon}"/>
                    </Border.Background>
                </Border>
                <TextBlock Margin="20 15" FontSize="30" Text="{Binding Path=SummonerName}" Foreground="DarkGray"/>
                <StackPanel Orientation="Horizontal" Margin="20 0">
                    <StackPanel Margin="5">
                        <TextBlock Text="胜" FontSize="15" FontWeight="Bold" Foreground="Green"/>
                        <TextBlock Text="{Binding Path=Wins}" FontSize="18" Foreground="Gray" HorizontalAlignment="Center"/>
                    </StackPanel>
                    <StackPanel Margin="5">
                        <TextBlock Text="输" FontSize="15" FontWeight="Bold" Foreground="DarkRed"/>
                        <TextBlock Text="{Binding Path=Losses}" FontSize="18" Foreground="Gray" HorizontalAlignment="Center"/>
                    </StackPanel>
                </StackPanel>
                <StackPanel Margin="30 20">
                    <TextBlock Text="水平" FontSize="15" Foreground="LightGray"/>
                    <TextBlock Text="{Binding Path=Level}" HorizontalAlignment="Center" FontSize="80" Foreground="Gray"/>
                </StackPanel>
                <Grid Margin="20 10">
                    <Button x:Name="ButtonSearch" HorizontalAlignment="Left" Style="{StaticResource MaterialDesignFlatButton}" Width="100" Click="ButtonSearch_Click">
                        <materialDesign:PackIcon Kind="Search" Width="24" Height="24"/>
                    </Button>
                    <Button HorizontalAlignment="Right" Width="100" Content="登录"/>
                </Grid>
            </StackPanel>
        </Border>
        <StackPanel HorizontalAlignment="Right" Margin="30 10">
            <Image Source="{Binding Path=Emblem}" Width="200" Height="200">
                <Image.Effect>
                    <DropShadowEffect BlurRadius="40" ShadowDepth="1"/>
                </Image.Effect>
            </Image>
            <StackPanel Orientation="Horizontal" HorizontalAlignment="Center" Margin="5">
                <TextBlock FontSize="18" Foreground="Gray" Text="{Binding Path=Tier}" Margin="5" VerticalAlignment="Center"/>
                <TextBlock FontSize="20" Foreground="Gray" Text="{Binding Path=Rank}" Margin="5"/>
            </StackPanel>
        </StackPanel>
    </Grid>
</Window>

概况信息展示界面

概况信息展示

2.4 简单的API接口调用封装

直接上代码看,Key.txt是存储的RIOT开发者Key:

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

namespace LoLGoal.API
{
    public class Api
    {
        private string Key { get; set; }
        private string Region { get; set; }

        public Api(string region)
        {
            Region = region;
            Key = GetKey("API/Key.txt");
        }

        protected HttpResponseMessage GET(string URL)
        {
            using (HttpClient client = new HttpClient())
            {
                var result = client.GetAsync(URL);
                result.Wait();

                return result.Result;
            }
        }

        protected string GetURI(string path)
        {
            return "https://" + Region + ".api.riotgames.com/lol/" + path + "?api_key=" + Key;
        }

        public string GetKey(string path)
        {
            StreamReader sr = new StreamReader(path);
            return sr.ReadToEnd();
        }
    }
}

2.5 其他代码

查看源码:get_profile_data

2.6 以下是站长方便演示、截图,修改的部分文件

可参考源码对比:

文件【API/League_V4.cs】

using LoLGoal.Model;
using System;
using System.Collections.Generic;

namespace LoLGoal.API
{
    public class League_V4 : Api
    {
        public League_V4(string region) : base(region)
        {
        }

        public List<PositionDTO> GetPositions(string summonerId)
        {
            //1、这是正常的API访问
            //string path = "league/v4/positions/by-summoner/" + summonerId;

            //var response = GET(GetURI(path));
            //string content = response.Content.ReadAsStringAsync().Result;

            //if (response.StatusCode == System.Net.HttpStatusCode.OK)
            //{
            //    return JsonConvert.DeserializeObject<List<PositionDTO>>(content);
            //}
            //else
            //{
            //    return null;
            //}

            //2、这是模拟数据,正常访问LOL服务器,需要注册Key
            string[] tiers = { "Bronze", "Challenger", "Diamond", "Gold", "Grandmaster", "Iron", "Master", "Platinum", "Silver" };
            var rd = new Random(DateTime.Now.Millisecond);
            var lst = new List<PositionDTO>();
            for (int i = 0; i < rd.Next(5, 20); i++)
            {
                lst.Add(new PositionDTO
                {
                    Tier = tiers[rd.Next(0, tiers.Length)],
                    Rank = "IV",
                    Wins = rd.Next(2, 100),
                    Losses = rd.Next(2, 100),
                    QueueType = "RANKED_SOLO_5x5"
                });
            }
            return lst;
        }
    }
}

文件【API/Summoner_V4.cs】

using LoLGoal.Model;
using System;

namespace LoLGoal.API
{
    public class Summoner_V4 : Api
    {
        public Summoner_V4(string region) : base(region)
        {
        }

        public SummonerDTO GetSummonerByName(string SummonerName)
        {
            //1、这是正常的API访问
            //string path = "summoner/v4/summoners/by-name/" + SummonerName;

            //var response = GET(GetURI(path));
            //string content = response.Content.ReadAsStringAsync().Result;

            //if(response.StatusCode == System.Net.HttpStatusCode.OK)
            //{
            //    return JsonConvert.DeserializeObject<SummonerDTO>(content);
            //}
            //else
            //{
            //    return null;
            //}

            //2、这是模拟数据,正常访问LOL服务器,需要注册Key
            return new SummonerDTO
            {
                ProfileIconId = DateTime.Now.Second,
                Name = SummonerName,
                SummonerLevel = new Random(DateTime.Now.Millisecond).Next(50, 200),
                Id = DateTime.Now.Second.ToString()
            };
        }
    }
}

3.参考

  1. 视频一:C# WPF Design UI – #1 – Login,配套源码:LoLGoal
  2. 视频二:C# WPF Design UI – #2 (1/2) – REST API Access,配套源码:get_summoner_data
  3. 视频三:C# WPF Design UI – #2 (2/2) – REST API Access,配套源码:get_summoner_data
  4. 视频四:C# WPF Design UI – #3 – Profile,配套源码:summoner_profile
  5. 视频五:C# WPF Design UI – #4 (1/2) – Get Data From RIOT API,配套源码:get_profile_data
  6. 视频六:C# WPF Design UI – #4 (2/2)- Get Data From RIOT API,配套源码:get_profile_data

最终源码:本文代码几乎和源码一致(第五和第六个视频配套Github源码 【get_profile_data】),站长未注册RIOT开发者Key,所以代码中采用模拟返回数据的方式,只展示了界面效果,并将部分英文改为中文,便于向大家展示此工程。

点击下载源码:get_profile_data

2020-06-16更新

本文演示源码已集成到开源项目,欢迎star,源码点击查看

除非注明,文章均由 Dotnet9 整理发布,欢迎转载。

转载请注明:
作者:Dotnet9
链接:https://dotnet9.com/7026.html
来源:Dotnet9
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。

发表评论

登录后才能评论