
랭킹을 불러오거나 광고를 띄우는 것처럼 네트워크가 필요한 기능 앞에서는, 기기가 지금 어떤 연결을 쓰고 있는지 먼저 살펴보는 경우가 많습니다. 연결이 아예 없으면 요청을 보내기 전에 안내 문구를 띄울 수 있고, 모바일 데이터라면 큰 파일을 받기 전에 한 번 물어볼 수도 있습니다. Unity에서는 Application.internetReachability가 현재 연결 종류를 NetworkReachability 값으로 알려 줍니다. 값은 연결 없음(NotReachable), 모바일 데이터(ReachableViaCarrierDataNetwork), 와이파이나 유선(ReachableViaLocalAreaNetwork) 세 가지입니다. 이번 예시에서는 1초마다 연결 종류를 읽어 화면 글자로 표시해 보도록 하겠습니다.
C# (UNITY 3D)

휴대폰에서 와이파이를 끄고 켜면 화면의 글자가 「와이파이 · 유선」과 「모바일 데이터」, 「연결 없음」으로 바뀌는 예시입니다.
using TMPro;
using UnityEngine;
글자를 표시하는 TMP_Text를 사용하기 위해 TMPro를 사용합니다.
Canvas에 TextMeshPro 텍스트를 하나 만들고, 빈 GameObject에 NetworkCheck.cs를 붙여 Text Network에 할당합니다.
using TMPro;
using UnityEngine;
//CodeFinder 코드파인더
//From https://codefinder.janndk.com/
public class NetworkCheck : MonoBehaviour
{
public TMP_Text text_network;
public float interval_check = 1f;
float time_check;
void Start()
{
Check_Network();
}
void Update()
{
time_check += Time.unscaledDeltaTime;
if (time_check < interval_check)
return;
time_check = 0f;
Check_Network();
}
void Check_Network()
{
// 연결 종류만 알려 줍니다. 실제로 서버에 닿는지는 따로 확인해야 합니다.
string state;
switch (Application.internetReachability)
{
case NetworkReachability.ReachableViaCarrierDataNetwork:
state = "모바일 데이터";
break;
case NetworkReachability.ReachableViaLocalAreaNetwork:
state = "와이파이 · 유선";
break;
default:
state = "연결 없음";
break;
}
if (text_network != null)
text_network.text = "네트워크: " + state;
}
}
변수(variable)
text_network(TMP_Text) : 연결 종류를 보여 줄 글자입니다.
interval_check(float) : 다시 확인하는 간격(초)입니다.
time_check(float) : 지난 확인 뒤 흐른 시간입니다.
함수(function)
Check_Network : internetReachability 값을 읽어 글자로 바꿉니다.
Update : 간격마다 Check_Network를 부릅니다.
주의
공식 문서는 이 값을 실제 연결 여부를 판단하는 데 쓰지 말고 연결 종류를 구분하는 데만 쓰라고 안내합니다. 와이파이에 붙어 있어도 그 공유기가 인터넷에 연결되어 있지 않을 수 있기 때문입니다. 그래서 「연결 없음」이 아닐 때도 실제 요청이 실패하는 경우를 처리해 두어야 합니다. 시간은 Time.unscaledDeltaTime으로 세어서, 일시정지로 Time.timeScale을 0으로 두어도 확인이 멈추지 않게 했습니다.
참고: Application.internetReachability · NetworkReachability · Time.unscaledDeltaTime
PC 같은 비휴대 플랫폼은 LAN에 연결 가능한 것으로 취급될 수 있습니다. 이 속성만으로 PC의 오프라인 상태를 감지하거나 서버 응답을 보장할 수 없습니다.
이 예제는 글을 위해 작성한 코드입니다. 전용 Unity 프로젝트 검사 결과는 별도로 기록하며, 기기에서의 화면과 플랫폼 동작을 보장하지 않습니다.
'Unity3D > C#' 카테고리의 다른 글
| 유니티 오브젝트 풀링으로 총알 다시 쓰기 (ObjectPool, Get, Release) (0) | 2026.11.20 |
|---|---|
| 유니티 스크린샷 찍어 저장하기 (CaptureScreenshot) (0) | 2026.11.19 |
| 유니티 모바일 터치 입력 받기 (Input.GetTouch, TouchPhase) (0) | 2026.11.18 |
| 유니티 볼륨 슬라이더 만들기 (AudioMixer.SetFloat, Mathf.Log10) (0) | 2026.11.17 |
| 유니티 클릭한 오브젝트 찾기 (Camera.ScreenPointToRay, Physics.Raycast) (0) | 2026.11.14 |