Skip to content

Unity 游戏怎么按玩家 IP 归属地分服、做同城匹配?C# 客户端完整实现 ​

上周有个做休闲对战的朋友来问:他们的游戏全国一个服,广州玩家和哈尔滨玩家进同一个房间,物理延迟差了一倍,投诉集中在「卡」。运营给的方案是分服,但分服得先知道玩家大概在哪;游戏里申请定位权限,转化率掉一大截,玩家一看要定位就点拒绝。

还有第二个需求更尴尬:他们想做一个「附近玩家」的入口,但是 GPS 在 PC 端和部分安卓设备上根本拿不到。两件事最后都落到同一个东西上——客户端拿一次 IP 归属地。

一、客户端侧为什么要用 IP,而不是 GPS ​

先把三种拿位置的方式摆开:

  • 系统定位(GPS/网络定位):精度高,但要弹权限框,被拒就没了;PC 端、主机端、部分模拟器上基本不可用。
  • 平台 SDK 的地理信息:只在特定渠道有,跨平台要写好几套。
  • IP 归属地:一次 HTTPS 请求,不申请任何权限,PC、手机、主机、模拟器都能跑,代价是精度只到城市、且是「网络出口的属地」而不是人站在哪。

对游戏客户端来说,后者的定位很清楚:它不是用来做精确位置的,而是用来做「默认值」和「粗筛池」。就近开服、同城匹配池、地域活动配置,这三件事都只需要知道玩家大概落在哪个省、哪个大区。

二、方案设计:在启动流程里加一次查询 ​

整体思路很短:

  1. 游戏启动(或进入主城前),客户端请求一次 https://ip9.com.cn/get——不传 ip 参数,接口直接返回当前请求方(也就是这台设备出口)的归属地;
  2. 拿到 prov(省)、city(市)、big_area(国内大区)三个字段;
  3. 结果写进 PlayerPrefs 缓存 6 小时,避免每次登录都打接口;
  4. 用三个字段分别驱动:就近开服(大区 → 服务器列表)、同城匹配偏好(城市 → 匹配池提示)、地域运营配置(语言/活动)。

几个关键取舍,先讲清楚再上代码:

  • 不要放在 Update 里轮询。归属地在一次游戏会话里几乎不会变,登录/切换账号时查一次就够。
  • 必须有兜底。接口超时、解析失败、限速的时候,客户端要能安静地走默认服,不能卡在加载界面。
  • 客户端拿到的东西不能当凭证。Unity 客户端可以被改包、被代理,归属地只适合做体验优化。凡是涉及封号、配额、投放预算的判定,服务端必须自己再查一次(服务端从请求里取 IP 比客户端上报可靠得多)。

三、C# 实现 ​

一个挂在启动场景空物体上的 MonoBehaviour 就够了。代码只用 Unity 自带 API,不引第三方库。

csharp
// IpRegionService.cs —— 游戏启动时查一次玩家属地(Unity 2020.2+)
using System;
using System.Collections;
using UnityEngine;
using UnityEngine.Networking;

[Serializable]
public class Ip9Data {
    public string ip, country, prov, city, isp, big_area;
    public string lng, lat, area_code, post_code;   // lng/lat 是城市中心点,别当精确坐标用
}

[Serializable]
public class Ip9Resp {
    public int ret;
    public Ip9Data data;   // 注意:出错时后端返回的是 [],强类型解析会拿到 null
}

public class IpRegionService : MonoBehaviour
{
    const string Api        = "https://ip9.com.cn/get";  // 不传 ip = 查当前请求方
    const string CacheKey   = "ip9.region";
    const int    CacheHours = 6;

    public string Prov    { get; private set; } = "";
    public string City    { get; private set; } = "";
    public string BigArea { get; private set; } = "";
    public bool   Ready   { get; private set; } = false;

    void Start()
    {
        if (LoadCache()) { ApplyRegion("cache"); return; }
        StartCoroutine(Fetch());
    }

    IEnumerator Fetch()
    {
        var req = UnityWebRequest.Get(Api);
        req.timeout = 5;                                    // 别让网络慢的玩家卡在这
        req.SetRequestHeader("User-Agent", "MyGame/1.0 (UnityWebRequest)");

        yield return req.SendWebRequest();

        bool   ok   = req.result == UnityWebRequest.Result.Success;
        string text = ok ? req.downloadHandler.text : null;
        string err  = req.error;
        req.Dispose();

        if (!ok) {
            Debug.LogWarning($"属地查询失败({err}),按默认大区开服");
            Ready = true; return;                           // 兜底:不阻塞进入游戏
        }

        Ip9Resp resp = null;
        try {
            resp = JsonUtility.FromJson<Ip9Resp>(text);
        } catch (Exception e) {
            Debug.LogWarning($"属地响应解析失败:{e.Message}");
        }

        // ret != 200(非法 IP 是 400、限速是 429)或 data 为空,一律当失败
        if (resp == null || resp.ret != 200 || resp.data == null
            || string.IsNullOrEmpty(resp.data.ip)) {
            Debug.LogWarning("属地数据不可用,走默认服");
            Ready = true; return;
        }

        Prov = resp.data.prov; City = resp.data.city; BigArea = resp.data.big_area;
        SaveCache();
        ApplyRegion("api");
    }

    void ApplyRegion(string from)
    {
        // ① 就近开服:大区映射到服务器列表,空值回落默认服
        string server = ServerList.ForRegion(BigArea, Prov);

        // ② 同城匹配池:把城市作为匹配偏好交给战斗服(服务端会复核)
        Matchmaking.SetPreferCity(City);

        // ③ 地域运营:活动/语言配置
        Debug.Log($"[{from}] 属地就绪:{Prov} {City}({BigArea})→ {server}");
        Ready = true;
    }

    // ---- PlayerPrefs 缓存:免费版 60 次/分钟/IP,别让同网吧出口撞限速 ----
    bool LoadCache()
    {
        string raw = PlayerPrefs.GetString(CacheKey, "");
        if (string.IsNullOrEmpty(raw)) return false;
        string[] p = raw.Split('|');
        if (p.Length < 4) return false;
        if (DateTime.UtcNow - DateTime.Parse(p[0]) > TimeSpan.FromHours(CacheHours)) return false;
        Prov = p[1]; City = p[2]; BigArea = p[3];
        ApplyRegion("cache");
        return true;
    }

    void SaveCache()
    {
        PlayerPrefs.SetString(CacheKey, $"{DateTime.UtcNow:O}|{Prov}|{City}|{BigArea}");
        PlayerPrefs.Save();
    }
}

调用侧只要在启动流程里 yield return new WaitUntil(() => svc.Ready); 再决定进哪个服,或者干脆不等——ApplyRegion 里给默认服,等回调回来再热切。前者实现简单,后者体验好,看你的加载流程怎么设计。

四、落地注意事项 ​

分服边界别按 IP 卡死。 IP 归属地是网络出口的属地,不是玩家所在地。常见的错位有三类:跨省漫游的手机流量出口可能落在邻省;公司/学校/网吧是共享出口,一屋子人一个属地;用了加速器的玩家,出口可能是别省的机房(反过来也能用——服务端拿 VIP 版的 ip_type 能识别 IDC 机房,这是识别工作室农场、模拟器批量登录的常用信号)。

所以规则要写成「优先 + 兜底」而不是「强制」:属地命中就分到对应大区,查不到或者玩家自己选了别的区,就按玩家选择走,别硬拦。

客户端能查到的,服务端也要能查。 客户端上报的归属地是可以伪造的,想靠它做「限制某个省的用户参与活动」这种带利益的规则,等于把门开着。正确姿势是服务端从 HTTP 请求里自己取 IP 再查一次,把客户端上报值只用来做体验优化。

缓存时长要按业务定。 6 小时是个折中值:移动端换网频繁,太长会把跨省出差的玩家一直锁在老服的推荐里;太短又会把接口调用量拉高。如果游戏体量大,可以在服务端做一层 IP→属地的共享缓存,客户端连查都不用查,登录接口里直接把属地返回给客户端。

IPv6 也要考虑。 现在不少移动网络默认走 IPv6,接口对 IPv4/IPv6 都支持,不需要客户端做特殊处理,但要注意 v6 下返回的 long_ip 是 0,别拿这个字段去做任何计算。

总结 ​

对游戏客户端来说,IP 归属地最好的定位是「一个不用权限的默认值」:登录时查一次、缓存起来,驱动开服选择、匹配偏好和地域配置,查不到就安静回落到默认逻辑。整套东西加起来不到一百行,比申请定位权限、写多套平台 SDK 简单得多。

接口只有一条:https://ip9.com.cn/get(不传参数查当前请求方,?ip=xxx 查指定 IP,IPv4/IPv6 都支持,免费版 60 次/分钟),返回字段里 prov、city、big_area、isp 对客户端场景够用了。需要识别 IDC 机房(ip_type)、拿到 ASN 或区县级精度时,走 VIP 版,具体能力以官网 https://www.ip9.com.cn 为准。