This document is about: FUSION 2
SWITCH TO

지역

Photon Cloud는 다양한 지역에 서버를 호스팅 하여 전 세계적으로 빠른 게임 환경을 제공합니다.

클라이언트는 Photon 네임 서버에서 지역 목록을 가져옵니다. 프로젝트의 수명 동안 새로운 지역이 추가되거나 오래된 지역이 더 이상 사용되지 않을 수 있습니다.

각 지역은 서로 완전히 독립적이며, 매치메이킹을 위한 마스터 서버와 룸을 호스팅 하는 게임 서버로 구성됩니다.

Photon Cloud Regions' Connect Flows
Photon Cloud 지역에 연결

사용 가능한 지역 목록은 제품(Fusion, Quantum, Chat 등)에 따라 다릅니다.
지역 허용 목록을 사용하여 AppId 별로 사용할 수 있는 지역을 정의할 수 있습니다(아래 참조).

아래는 이 제품에 대한 지역 목록입니다.

사용 가능한 지역

Photon Cloud는 전 세계 여러 호스팅 센터에 분산된 여러 지역의 서버로 구성되어 있습니다.
일부 지역 서버는 특정 제품 및 클라이언트 SDK만 지원합니다. 예를 들어, Fusion 클라이언트는 일본 지역을 사용할 수 있지만 Chat은 사용할 수 없습니다.

각 Photon Cloud 지역은 대소문자를 구분하지 않는 짧은 문자열인 "지역 토큰"으로 식별됩니다.
예: "EU" 또는 "eu"는 동일한 유럽 지역을 나타냅니다.

지역호스팅 위치토큰
지역호스팅 위치토큰
호주시드니au
캐나다 동부몬트리올cae
중국 본토 (설명 보기)상하이cn
유럽암스테르담eu
홍콩홍콩hk
인도첸나이in
일본도쿄jp
남아메리카상파울루sa
대한민국서울kr
터키이스탄불tr
아랍에미리트두바이uae
미국 동부워싱턴 D.C.us
미국 서부산호세usw
미국 남중부댈러스ussc

산업 서클에는 다음과 같은 Fusion 지역이 있습니다:

지역호스팅 위치토큰
아시아싱가포르asia
유럽암스테르담eu
인도첸나이in
일본도쿄jp
대한민국서울kr
미국 동부워싱턴 D.C.us

허용 지역 목록

허용 지역 목록을 사용하면 관리 화면에서 애플리케이션 별로 사용 가능한 지역을 직접 사용자 정의할 수 있습니다. 최적의 지역 기능을 사용하는 클라이언트는 자동으로 조정됩니다.

더 많은 지역을 사용하거나 줄임으로써 서비스 품질(플레이어와 가까운 지역일수록 왕복 시간이 더 짧아짐)과 매치메이킹 경험(적은 지역일수록 지역당 더 많은 플레이어를 의미함) 간의 균형을 맞출 수 있습니다.

앱별로 지역을 정의하려면, 관리 화면 열기, 선택한 애플리케이션의 "관리"를 클릭한 다음 "허용 목록 편집"을 클릭하십시오. 다음과 같이 허용 지역 목록을 입력할 수 있는 입력 필드가 제공됩니다:

  • 사용 가능한 지역은 위에서 SDK 별로 나열되어 있으며, 때로는 산업 서클에 대해 별도로 나열됩니다.
  • 허용 목록은 세미콜론으로 구분된 지역 토큰 문자열이어야 합니다. 예: "eu;us".
  • 지역 토큰은 대소문자를 구분하지 않습니다.
  • 정의되지 않았거나 인식되지 않은 지역 토큰은 목록에서 무시됩니다.
  • 빈 문자열("") 또는 잘못된 형식 문자열(예: ";;;")은 모든 사용 가능한 지역이 허용됨을 의미합니다.

변경(확인 및 저장) 후 10분 이내에 네임 서버가 필터링 된 목록을 연결 클라이언트에 전송합니다.
클라이언트 측의 충돌을 피하려면 핑을 통해 "최적의 지역"에 연결하거나 지역 목록에서 받은 지역을 선택하십시오.

참고: 인기 있는 앱의 사용 가능한 지역을 변경하면 여러 지역에서 피크 CCU에 영향을 미치며, 이는 구독 요금의 기준이 됩니다. 더 비싼 초과 요금을 피하기 위해 구독 플랜을 필요한 만큼 조정하십시오. 전환이 안정된 후에는 구독을 줄이는 것도 완전히 괜찮습니다.

지역 선택 방법

미국 사용자는 Photon Cloud의 미국 지역에 연결할 경우 가장 낮은 지연 시간을 경험할 수 있습니다. 간단합니다.


하지만 전 세계에 사용자가 있다면 어떻게 해야 할까요?

옵션은 다음과 같습니다..

  • a) 게임 클라이언트가 다양한 Photon Cloud 지역에 핑을 보내고 가장 낮은 핑의 지역을 미리 선택하도록 설정합니다. 방법 보기를 참조하세요.
  • b) 지역에 맞춘 클라이언트 빌드를 배포하여, 서로 다른 지역의 사용자가 다른 Photon Cloud 지역에 연결되도록 합니다.
  • c) 게임 UI 내에서 사용자가 적합한 지역을 선택할 수 있도록 합니다.
  • d) 높은 지연 시간이 게임 플레이에 영향을 주지 않는다면, 모든 사용자를 동일한 지역에 연결시킵니다.

모든 Photon Cloud 앱은 추가 비용 없이 모든 사용 가능한 지역에서 작동합니다.

가격 정보 보기

Photon Cloud의 대시보드를 통해 각 지역에서 게임의 사용량을 모니터링하고 구독 플랜을 손쉽게 업그레이드하거나 다운그레이드 할 수 있습니다.

관리 화면으로 이동

최적의 지역에 대한 고려 사항

"최적 지역" 옵션은 결정론적이지 않습니다.
때로는 약간의 변동성 또는 정확히 동일한 핑 계산으로 인해 "무작위" 일 수 있습니다.

이론적으로 가능한 것:

  • 동일한 기기에서 여러 영역으로 동일한 핑 값을 가진 경우입니다. 따라서 동일한 네트워크에 연결된 클라이언트는 무작위로 다른 지역에 연결됩니다.
  • 동일 네트워크에 연결된 서로 다른 기기에서 동일한 지역에 대하여 서로 다른 핑 값(또는 동일한 기기에서 다른 시도)

예를 들어, "us" 그리고 "usw"인 경우(또는 "ru" 그리고 "rue")에, 원하는 지역을 선택 또는 나머지 지역을 없앨 수 있도록 온라인 지역 화이트리스트를 사용할 수 있거나 지역을 지정하여 접속할 수 있습니다.

런타임에 지역 선택 방법

기본적으로 PhotonAppSettings 또는 코드로 지역이 설정되지 않은 경우, Fusion은 최적의 지역에 연결을 시도합니다.
즉, 시작 시 모든 사용 가능한 지역에 핑을 보내고 가장 낮은 핑의 지역에 연결합니다.
그러나 최적의 지역은 결정론적이지 않으며, 작은 차이나 동일한 핑 값 계산으로 인해 때때로 "랜덤"하게 선택될 수 있습니다.

최적의 지역 기능이 필요하지 않은 경우, 플레이어가 런타임에 연결할 지역을 선택하도록 할 수 있습니다.
이 방법은 플레이어가 공통된 지역에 연결하거나 특정 지역에서 친구와의 세션에 참여하고자 할 때 핑을 낮추는 데 도움이 됩니다.

사용 가능한 지역 목록을 얻으려면, Fusion은 NetworkRunner.GetAvailableRegions() 메서드를 제공합니다.
이는 지역 이름과 핑 값을 포함하는 Fusion.RegionInfo 객체의 목록을 반환합니다.
이 목록을 사용하여 핑 값이 가장 낮은 순서로 정렬하거나, 플레이어가 원하는 지역을 선택하도록 할 수 있습니다.

지역 선택은 NetworkRunner실행 중이지 않을 때만 가능합니다.
특정 지역에 이미 연결된 상태에서는 이를 변경할 수 없습니다.
아래 코드 스니펫은 NetworkRunner가 런타임에 사용자 지정 지역을 사용하는 방법을 보여줍니다:

C#

public class FusionInit : MonoBehaviour {

    // ...

    // Start a NetworkRunner with a Game Mode and connect to the specified Region
    public Task<StartGameResult> StartSimulation(NetworkRunner runner, GameMode gameMode, string region) {

        var appSettings = BuildCustomAppSetting(region);

        return runner.StartGame(new StartGameArgs() {
            // ...
            GameMode = gameMode,
            CustomPhotonAppSettings = appSettings
        });
    }

    private FusionAppSettings BuildCustomAppSetting(string region, string customAppID = null, string appVersion = "1.0.0") {

        var appSettings = PhotonAppSettings.Global.AppSettings.GetCopy();;

        appSettings.UseNameServer = true;
        appSettings.AppVersion = appVersion;

        if (string.IsNullOrEmpty(customAppID) == false) {
            appSettings.AppIdFusion = customAppID;
        }

        if (string.IsNullOrEmpty(region) == false) {
            appSettings.FixedRegion = region.ToLower();
        }

        // If the Region is set to China (CN),
        // the Name Server will be automatically changed to the right one
        // appSettings.Server = "ns.photonengine.cn";

        return appSettings;
    }
}

Get Available Regions At Runtime

It is possible to get a list of available regions at runtime using and awaiting the static method NetworkRunner.GetAvailableRegions(),
An example of use is shown below.

C#

public Dropdown Dropdown;
  
private async void RefreshRegionDropdown() {
    _tokenSource = new CancellationTokenSource();
    
    var regions = await NetworkRunner.GetAvailableRegions(cancellationToken: _tokenSource.Token);
    Dropdown.options.Clear();
    Dropdown.AddOptions(regions.Select(reg => $"{reg.RegionCode} = {reg.RegionPing}").ToList());
}

NOTE: A NetworkRunner must exist in the scene.

중국 본토 지역 사용

Photon 애플리케이션에서 중국 본토 지역에 액세스하려면 요청이 필요합니다. AppID를 해제하려면 이메일을 보내주세요.
대시보드에서는 중국 본토 지역에서 사용할 유료 플랜을 구독할 수 없습니다. 구독에 대한 견적을 받으려면 [email protected]으로 이메일을 보내주세요.

Photon 네임 서버는 중국 내에서 로컬이어야 합니다. 그렇지 않으면 방화벽이 트래픽을 차단할 수 있습니다.
중국 Photon 네임 서버는 "ns.photonengine.cn"입니다.

중국 본토 외부에서 클라이언트와 연결하면 결과가 좋지 않을 가능성이 높습니다.
또한, Photon 서버에서 중국 본토 외부 서버(예: Custom Authentication, WebHooks, WebRPCs)로의 연결은 신뢰할 수 없을 수 있습니다.

중요: 현재 단계에서는 대시보드를 통해 앱에 변경한 사항이 중국 앱 캐시에 자동으로 반영되지 않습니다. 업데이트 요청이 있는 경우 이메일로 알려주세요.

법적 이유로 중국에 별도의 빌드가 필요하며, 이를 위해 별도의 AppID를 사용하는 것을 권장합니다.
예를 들어, 컴파일 조건을 사용하여 빌드에 따라 AppID와 Photon 네임 서버를 변경할 수 있습니다.

중국 시장을 위한 특별 빌드를 만들려면 클라이언트 SDK에 해당하는 지침을 따르세요.

Fusion

PhotonAppSettings 사용하기

Fusion: PhotonAppSettings for China
Fusion: 중국용 PhotonAppSettings

코드 사용하기

C#

public class FusionInit : MonoBehaviour {

    // ...

    async void ConnectToChina()
    {
        var runner = BuildNetworkRunnerInstance();

        // Start new Runner with the Host Migration Token
        var result = await StartSimulation(
            runner,
            GameMode.AutoHostOrClient, // Or any other GameMode
            "cn" // Select China Region
        );

        // Check results as usual
        if (result.Ok == false) {
            Debug.LogWarning(result.ShutdownReason);
        } else {
            Debug.Log("Done");
        }
    }
}
Back to top