본문 바로가기

Unity3D/C#

유니티 인터넷 연결 종류 확인 (internetReachability)

반응형

대표 그림

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

C# (UNITY 3D)

실제 Unity 화면이 아닌 코드 설명 도식

휴대폰에서 와이파이를 끄고 켜면 화면의 글자가 「와이파이 · 유선」과 「모바일 데이터」, 「연결 없음」으로 바뀌는 예시입니다.

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 프로젝트 검사 결과는 별도로 기록하며, 기기에서의 화면과 플랫폼 동작을 보장하지 않습니다.

반응형

Google Play 및 Google Play 로고는 Google LLC의 상표입니다.