지역

Photon 클라우드는 전 세계에서 낮은 레이턴시 게이밍을 위하여 글로벌 접속을 제공합니다.

클라이언트의 초기 접속은 Photon 네임 서버로 가게 되며, 여기에서는 사용할 수 있는 지역을 제공합니다.

각 지역은 타지역과 완벽하게 분리되어 있으며 마스터 서버(매치메이킹 용)와 게임 서버(호스팅 룸) 이루어져 있습니다.

Photon Cloud Regions' Connect Flows
Connect to Photon Cloud regions

사용할 수 있는 전체 지역은 아래에 있습니다. 관리 화면에서, 클라이언트에서 사용할 수 있는 지역을 정의할 수 있습니다.

목차

최적의 지역 선택

PUN과 Photon Voice는 최적의 지역을 선택하기 위해서 Realtime API 레이어에 의존적입니다.

메인 화면으로

C# Realtime API

Photon Realtime은 연결하기에 가장 적합한 지역을 감지할 수 있으며 해당 지역을 고수할 수 있도록 지원합니다.

이를 위해 클라이언트는 항상 연결할 때 네임 서버에서 사용 가능한 지역 목록을 가져옵니다. 최신 지역 목록을 가져오고 저장된 최적의 지역(있는 경우)이 여전히 사용 가능한지 확인하는 데 사용됩니다.

서버를 ping 한 후 결과는 나중에 사용할 수 있도록 장치에 저장해야 하는 문자열로 요약합니다. 요약된 문자열에는 현재 가장 좋은 지역, 해당 ping 및 현재 지역 목록이 포함됩니다.

이전 세션의 결과가 없으면 모든 지역에 ping이 수행되므로 시간이 더 오래 걸립니다. 이전 결과를 사용할 수 있는 경우 클라이언트는 다음을 확인합니다.

a. 지역 목록이 변경된 경우("이전 최적 지역"이 여전히 사용 가능한 경우입니다)
b. ping이 더 이상 허용되지 않는 경우(>= 이전에 저장한 기준 값보다 1.5배 느림)입니다.

둘 중 하나가 적용되면 모든 지역으로 ping 되고 새 결과가 선택됩니다.

최적의 지역을 사용하면 관리 화면의 서버 측 영역 필터와 함께 사용할 수 있습니다. 플레이어가 온디맨드 방식으로 사용할 수 있는 지역 목록을 변경할 수 있습니다.

지역 목록에 접근하거나 이전 결과를 재정의하려면 지역에 대한 API 레퍼런스를 참조합니다.

메인 화면으로

최적 지역 고려 사항

"Best Region" option is not deterministic. Sometimes it may be "random" due to little variations or exact same ping calculations.

Theoretically, you could:

  • have the same exact ping to multiple regions from the same device. So its random, if you end up with different regions on clients connected to the same network.
  • different ping values for the same region on different devices (or different retries on the same device) connected to the same network.

For instance, in the case of "us" and "usw" (or "ru" and "rue"), you could either make use of the online regions whitelist to select the ones you want and drop the others or connect to an explicit region.

메인 화면으로

사용할 수 있는 지역

Photon 클라우드에는 몇 개의 지역이 있으며 전 세계적으로 분산된 다수의 호스팅 센터가 있습니다.

각 Photon 클라우드 지역은 "지역 토큰"에 의해 구별됩니다.

클라이언트의 "Connect" 메소드에 지역 토큰을 전달하기 위해서 다음을 호출합니다:

    loadBalancingClient.ConnectToRegionMaster(regionString);

사용할 수 있는 지역과 토큰 목록:

지역 토큰(또는 코드)문자열은 대소문자가 구별됩니다. 예: "EU" 또는 "eu" 모두 수용하며 동일한 유럽 지역을 나타냅니다.
지역호스트 위치토큰
아시아싱가포르asia
호주멜버른au
캐나다, 동부몬트리올cae
중국 본토1 (지침을 참고하세요)상하이cn
유럽암스테르담eu
인도첸아이in
일본도쿄jp
러시아모스코바ru
러시아, 동부하바로프스크rue
남 아프리카2요하네스버그za
남 아메리카상파울루sa
한국서울kr
USA, 동부워싱턴 D.C.us
USA, 서부산호세usw

1: 중국 본토 지역은 AppId와 구독을 분리해야 합니다. 2: 남 아프리카 지역은 아직 예비 시험 중입니다.

메인 화면으로

관리 화면 지역 필터링

관리 화면에서 바로 직접 어플리케이션별로 사용할 수 있는 Photon Cloud 지역 목록을 필터링할 수 있습니다.

Photon Cloud: Regions Whitelist
Photon Cloud 지역 필터링

관리 화면으로 이동하여 선택한 어플리케이션의 "관리"를 클릭하고 "편집" 을 클릭합니다. 다음과 같이 바람직한 지역의 목록을 입력할 수 있는 입력 필드를 찾을 수 있을 것입니다:

  • 허용된 목록은 세미콜론으로 분리된 지역 토큰 문자열이어야 합니다. 예를 들어, "eu;us".
  • 지역 토큰은 대소문자를 구별하고 여기에 정의되어 있습니다.
  • 정의되지 않았거나 식별할 수 없는 지역 토큰들은 목록에서 무시됩니다.
  • 비어 있는 ("") 또는 잘못된 형식의 문자열 (예, ";;;") 은 빈 목록을 나타냅니다.
  • 빈 목록은 모든 지역을 사용하도록 허용하는 것을 의미합니다.

확인하고 저장하면, GetRegions 오퍼레이션은 필터링 된 지역 목록만을 리턴할 것입니다. 따라서 클라이언트들은 그 목록에서 선택해야 하지만 명시적으로 사용할 수 있는 모든 지역에 연결하는 것이 가능합니다. 관리 화면에서 변경사항을 적용하기까지는 최대 10분까지 걸릴 수 있다는 것을 고려해 주시기 바랍니다.

메인 화면으로

지역 선택 방법

미국 내 사용자들은 미국 지역의 Photon Cloud에 접속한 경우 가장 낮은 레이턴시를 가지게 됩니다. 참 쉽죠.

하지만 사용자들이 전 세계에 있는 경우는 어떻게 해야 할까요?

다음을 할 수 있습니다

  • a) 게임 클라이언트가 다른 Photon Cloud 지역으로 핑을 날려서 최적의 핑을 보여주는 지역을 사전-선택 합니다. 방법을 읽어 보세요
  • b) 지역별로 구분한 클라이언트 버전을 배포하여 사용자들이 지역별로 해당 지역의 Photon Cloud에 접속하도록 합니다. 또는
  • c) 게임 메뉴에서 사용자들이 지역을 선택하도록 합니다.

또한 d) 게임 플레이에서 높은 레이턴시를 감당할 수 있는 경우, 모든 사용자들이 동일한 지역에 접속하게 할 수도 있습니다. 예를 들면, "리얼타임이 아닌" 게임인 경우입니다.

모든 Photon Cloud 앱들은 사용할 수 있는 모든 지역에서 추가 요금 없이 동작합니다. 가격 보기.

Photon Cloud의 관리 화면에서는 각 지역의 게임 사용량을 모니터링할 수 있으며 구독 플랜을 쉽게 업그레이드하거나 다운그레이드 할 수 있습니다. 관리 화면으로 이동.

메인 화면으로

가장 낮은 레이턴시로 게임을 시작하는 방법

Photon Cloud Regions' Connect Flows
Photon Cloud 지역으로 접속하기

메인 화면으로

가장 가까운 마스터 서버에 접속하기

일반적인 지역 마스터 서버 주소를 사용하여 마스터 서버에 직접 접속하는 것은 더 이상 사용되지 않습니다. 대신에 사용하고 있는 SDK에서 제공되는 지역 마스터로 연결하는 메소드를 사용하게 됩니다!

클라이언트에서 가장 가까운 지역을 알고 있다면 지역만을 전달하여 접속할 수 있습니다.

    loadBalancingClient.ConnectToRegionMaster("us");

다른 플랫폼에 대해서는 SDK 목록에서 각각의 SDK와 API 링크를 따라가 보세요.

SDK는 네임 서버로부터 요청된 지역의 마스터 서버 주소를 얻게 됩니다. (그림 1번 "Photon Cloud 지역으로 접속하기") 그리고 선택한 지역 내의 마스터 서버로 자동으로 연결 (그림 2번 "Photon 클라우드 지역으로 접속하기") 합니다.

메인 화면으로

런타임시 지역을 선택하는 방법

런타임에 지역을 선택하고 싶은 경우에는 - 예를 들어, 플레이어에게 모든 지역 리스트를 보여주어 지역을 선택하는 것 - 먼저 네임 서버에 접속해야 합니다. 현재 사용할 수 있는 지역 마스터 서버 주소를 네임 서버로 질의할 수 있습니다. (그림 1번 "Photon Cloud 지역으로 접속하기")

우리가 쓰고 있는 "네임서버"는 사용할 수 있는 지역에 대해 지역적으로 로드 밸런싱 된 네임 서버입니다. 네임서버는 마스터 서버 주소 요청을 최대한 시간을 낮게 유지합니다.

메인 화면으로

C# 클라이언트 SDK

    loadBalancingClient.ConnectToNameServer()

연결이 성공하면 사용 가능한 지역 목록을 얻습니다.

    loadBalancingClient.OpGetRegions()

이제 마스터 서버들의 목록에서 게임 플레이를 위하여 낮은 레이턴시를 가진 가장 좋은 지역을 알아보기 위하여 ping을 할 수 있으며 플레이어들이 지역을 선택하도록 할 수도 있습니다.

클라이언트가 지역을 결정했을때, 그 지역의 마스터 서버로 접속합니다(그림 2번 "Photon Cloud 지역으로 접속하기").

    loadBalancingClient.ConnectToRegionMaster("us")

마지막으로, 게임을 위한 룸에 참여하거나 생성합니다.(그림 3번 "Photon Cloud로 클라이언트 접속하기").

메인 화면으로

C++ 클라이언트 SDK

  1. Client 클래스의 생성자에는 몇 가지 선택적인 파라미터가 있습니다. 그중 마지막은 regionSelectionMode이라고 부르며 LoadBalancing::RegionSelectionMode의 값 중 하나를 가지며 기본값은 RegionSelectionMode::DEFAULT입니다. 이 파라미터는 명시적으로 RegionSelectionMode::SELECT를 전달합니다.

  2. Client::connect()를 호출하여 트리거되는 연결 흐름동안 클라이언트는 네임 서버에서 사용할 수 있는 지역 목록을 수신합니다. Listener는 선택적인 Listener::onAvailableRegions() 콜백을 선언합니다. regionSelectionMode에서 RegionSelectionMode::SELECT를 전달한 경우, Client는 사용할 수 있는 지역 목록에서 항목을 자동적으로 선택하지 않지만, 콜백에 목록을 전달합니다. 따라서 Listener 구현 내에서 해당 콜백의 빈 기본 구현을 오버라이드 할 수 있는 모든 기준에 따라 지역을 선택하는 의미 있는 구현으로 재정의해야 합니다.

  3. 지역을 선택하기 전까지 연결 흐름은 완전히 멈추게 됩니다.

  4. 연결 흐름을 계속하려면 Client::selectRegion()으로 선택한 지역을 전달하십시오.

참고: Client::selectRegion() 은 Listener::onAvailableRegions() (이 콜백 내에서 직접적으로 selectRegion() 호출 또는 나중에 콜백이 리턴된 이후)에 대한 호출 수신 이후에만 호출될 것으로 예측됩니다. 그렇지 않으면 클라이언트는 지역 선택의 연결-흐름의 올바른 단계에 있지 않게 될 것입니다.

Listener::onAvailableRegions() 의 구현 예제는 클라이언트 SDK 내의 demo_loadBalancing 의 소스 코드에서 확인하실 수 있습니다:

void NetworkLogic::onAvailableRegions(const ExitGames::Common::JVector<ExitGames::Common::JString>& availableRegions, const ExitGames::Common::JVector<ExitGames::Common::JString>& availableRegionServers)
{
    EGLOG(ExitGames::Common::DebugLevel::INFO, L"%ls / %ls", availableRegions.toString().cstr(), availableRegionServers.toString().cstr());
    mpOutputListener->writeLine(L"onAvailableRegions: " + availableRegions.toString() + L" / " + availableRegionServers.toString());
    // select first region from list
    mpOutputListener->writeLine(L"selecting region: " + availableRegions[0]);
    mLoadBalancingClient.selectRegion(availableRegions[0]);
}

selectRegion() 은 onAvailableRegions() 호출이 수신된 이후에만 연결-흐름 동안에 호출되는 점을 참조하여 주세요. onAvailableRegions()을 다른 시점에서 또는 다른 상태 또는 반복적으로 호출하는 것은 지원되지 않으며 정의되지 않은 행동을 유발하게 됩니다.

메인 화면으로

Objective-C 클라이언트 SDK

  1. EGLoadBalancingClient 생성자는 두 개의 선택적인 파라미터가 있습니다. 파라미터 중 마지막 것은 regionSelectionMode라고 하며, EGRegionSelectionMode.h의 값을 받고 기본값은 EGRegionSelectionMode_DEFAULT입니다. 이 파라미터에 명시적으로 EGRegionSelectionMode_SELECT를 전달해주세요.

2.EGLoadBalancingClient::connect() 호출에 의하여 발생되는 연결 흐름 과정에서, 클라이언트는 네임 서버로부터 사용 가능한 지역들의 목록을 받습니다. EGLoadBalancingListener에서 선택적인 콜백인 EGLoadBalancingListener::onAvailableRegions()를 선언합니다. regionSelectionMode에 대해서 EGRegionSelectionMode_SELECT 값을 전달하지 않은 경우에, EGLoadBalancingClient는 사용할 수 있는 지역 목록에서 자동적으로 항목을 선택하지 않지만, 콜백으로 목록을 전달합니다. 따라서 EGLoadBalancingListener 구현에서는 기준에 따라 지역을 선택 할 수 있도록 콜백의 빈 기본 구현을 오버라이드 해 주어야 합니다.

  1. 연결 흐름은 지역을 선택하기 전까지 완전히 멈추게 됩니다.

  2. 연결 과정을 계속 하기 위해 선택한 지역을 EGLoadBalancingClient::selectRegion()에 전달합니다.

참고: EGLoadBalancingClient::selectRegion() 은 EGLoadBalancingListener::onAvailableRegions() (이 콜백 내에서 직접적으로 selectRegion() 호출 또는 나중에 콜백이 리턴된 이후)에 대한 호출 수신 이후에만 호출될 것으로 예측됩니다. 그렇지 않으면 클라이언트는 지역 선택의 연결-흐름의 올바른 단계에 있지 않게 될 것입니다.

EGLoadBalancingListener::onAvailableRegions()에 대한 구현 예제는 클라이언트 SDK 내의 demo_loadBalancing_objc 소스코드에서 보실 수 있습니다:

- (void) onAvailableRegions:(EGArray*)availableRegions :(EGArray*)availableRegionServers
{
    NSString* r = [availableRegions componentsJoinedByString:@", "];
    NSString* s = [availableRegionServers componentsJoinedByString:@", "];
    EGLOG(EGDbgLvl::INFO, L"onAvailableRegions: %ls / %ls", [r UTF32String], [s UTF32String]);
    [mOutputListener writeLine:@"onAvailableRegions: %@ / %@", r, s];
    // select first region from list
    [mOutputListener writeLine:@"selecting region: %@", availableRegions[0]];
    [mLoadBalancingClient selectRegion:availableRegions[0]];
}

selectRegion() 은 onAvailableRegions() 호출이 수신된 이후에만 연결-흐름 동안에 호출되는 점을 참조하여 주세요. onAvailableRegions()을 다른 시점에서 또는 다른 상태 또는 반복적으로 호출하는 것은 지원되지 않으며 정의되지 않은 행동을 유발하게 됩니다.

메인 화면으로

중국 본토 지역에서 사용하기

먼저, Photon 앱에서 중국 본토 지역으로의 접속을 요청해야 합니다. 저희가 귀하의 AppID를 잠금 해제 할 수 있도록 저희에게 메일을 보내주세요.
둘째, 저희 웹사이트를 통해서는 중국 본토에서 사용할 유료 요금제에 가입할 수 없습니다. 이메일로 연락 주세요.

방화벽이 트래픽을 차단할 수도 있으므로, Photon 네임서버는 중국에서만 국한되어야 합니다. 중국 Photon 네임서버는 "ns.photonengine.cn"입니다.

중국 본토 밖의 고객과 연결하는 것은 대부분 좋은 결과를 얻을 수 없을 것입니다. 또한 Photon 서버에서 중국 본토 이외의 서버 (예:사용자 정의 인증, WebHooks, WebRPC)로 연결하는 것은 신뢰할 수 없을 것입니다.

중요: 현재 단계에서, 관리 화면을 통해 앱을 변경하는 것은 중국의 앱 캐시에 자동적으로 반영되지 않습니다. 갱신 요청이 있는 경우에, 우리에게 이메일로 알려주시기 바랍니다.

또한 법적인 이유로 중국을 위해 빌드를 분리하는 것이 필요하며, 별도의 AppId를 사용하는 것을 권장합니다. 예를 들어, 빌드 조건에 따라 AppId와 Photon 네임서버를 변경하려면 컴파일 조건(원하는 경우)을 사용하시기 바랍니다

중국 시장을 위한 특별한 빌드 구성에 대해서는 다음 지침을 따라 주세요:

메인 화면으로

C# 클라이언트 SDKs

void ConnectToChina()
{
    loadBalancingClient.NameServerHost = "ns.photonengine.cn";
    loadBalancingClient.AppId = "ChinaRealtimeAppId"; // TODO: replace with your own AppId
    loadBalancingClient.AppVersion = "ChinaAppVersion"; // optional
    loadBalancingClient.ConnectToRegionMaster("cn");
}

메인 화면으로

C++ 클라이언트 SDKs

  • Client::connect() 의 serverAdress 파라미터에 "ns.photonengine.cn" 을 전달합니다.
  • serverType 이 기본 값인 ServerType::NAME_SERVER 로 유지 되고 있는지 확인해주세요.

메인 화면으로

Objective-C 클라이언트 SDK

  • EGLoadBalancingClient::connect() 로 serverAdress 파라미터를 "ns.photonengine.cn" 으로 전달합니다.
  • serverType 파라미터가 기본 값인 EGServerType_NAME_SERVER 로 유지 되고 있는지 확인해주세요.


기술문서 TOP으로 돌아가기