Appearance
Unity 游戏怎么按玩家 IP 归属地分服、做同城匹配?C# 客户端完整实现
上周有个做休闲对战的朋友来问:他们的游戏全国一个服,广州玩家和哈尔滨玩家进同一个房间,物理延迟差了一倍,投诉集中在「卡」。运营给的方案是分服,但分服得先知道玩家大概在哪;游戏里申请定位权限,转化率掉一大截,玩家一看要定位就点拒绝。
还有第二个需求更尴尬:他们想做一个「附近玩家」的入口,但是 GPS 在 PC 端和部分安卓设备上根本拿不到。两件事最后都落到同一个东西上——客户端拿一次 IP 归属地。
一、客户端侧为什么要用 IP,而不是 GPS
先把三种拿位置的方式摆开:
- 系统定位(GPS/网络定位):精度高,但要弹权限框,被拒就没了;PC 端、主机端、部分模拟器上基本不可用。
- 平台 SDK 的地理信息:只在特定渠道有,跨平台要写好几套。
- IP 归属地:一次 HTTPS 请求,不申请任何权限,PC、手机、主机、模拟器都能跑,代价是精度只到城市、且是「网络出口的属地」而不是人站在哪。
对游戏客户端来说,后者的定位很清楚:它不是用来做精确位置的,而是用来做「默认值」和「粗筛池」。就近开服、同城匹配池、地域活动配置,这三件事都只需要知道玩家大概落在哪个省、哪个大区。
二、方案设计:在启动流程里加一次查询
整体思路很短:
- 游戏启动(或进入主城前),客户端请求一次
https://ip9.com.cn/get——不传ip参数,接口直接返回当前请求方(也就是这台设备出口)的归属地; - 拿到
prov(省)、city(市)、big_area(国内大区)三个字段; - 结果写进
PlayerPrefs缓存 6 小时,避免每次登录都打接口; - 用三个字段分别驱动:就近开服(大区 → 服务器列表)、同城匹配偏好(城市 → 匹配池提示)、地域运营配置(语言/活动)。
几个关键取舍,先讲清楚再上代码:
- 不要放在
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 为准。