버전 비교

버전 이전 버전 1 새 버전 2
변경한 사람

Eric

QATEAM

에 저장

키

  • 이 줄이 추가되었습니다.
  • 이 줄이 삭제되었습니다.
  • 서식이 변경되었습니다.
도움말

게임에 시스템 정보 연동 방법을 안내합니다This guide explains how to integrate system information into the game.

하위 페이지(하위 항목 표시)
allChildrentrue

시스템 정보란?

  • 현재 기기의 정보를 알 수 있는 API를 제공합니다.

제공 정보

...

정보

...

의미

...

언어 코드

...

  • 기기에 설정되어 있는 언어 설정 정보를 가져오며, 언어 코드는 ISO 639-1 표준에 따른 값을 반환합니다.

...

국가 코드
(2가지 API 제공)

...

  • 국가 코드를 가져오는 우선 순위

    • 1순위) 캐싱된 국가 코드

      • 캐싱된 국가 코드가 없을 경우, 1순위 사용

    • 2순위) GEO IP기반의 국가 코드

      • 서버로 비동기 요청

      • 에러가 "1001", "2001" 일 경우, 호출하는 start함수에서 에러 발생

      • 정상적으로 가져올 경우, 내부 캐싱

      • 정상적으로 못 가져오는 모든 상황("zz"인 경우 포함)의 경우, 3순위 사용

    • 국가 코드는 ISO 3166-1 alpha-2 표준을 따르며 국가 정보가 없을 경우에는 “zz” 를 반환합니다.

    • 지리적 정보(Geo IP)에 따라 user와 app(게임)의 서비스 범위를 제한(허용)하기 위해 USER가 최초 로그인 시 회원 DB에 저장되는 회원의 국가 정보

    • 캐싱된 국가 정보는 다음의 조건에서 초기화, 단 회원에 저장된 국가 정보는 “탈퇴” 시에만 삭제 되기 때문에 캐싱 초기화 후 재로그인 시 회원의 국가와 동일한 국가 정보로 캐싱 됩니다. (단, 회원 탈퇴 후 신규 가입인 경우엔 회원 DB와 캐싱 국가가 모두 신규로 저장)

...

  • GEO IP 기반 국가 코드

    • 기기가 현재 접속한 네트워크의 Geo IP기반으로 국가 코드를 반환합니다.

    • 지리적 정보(Geo IP)에 따라 user와 app(게임)의 서비스 범위를 제한(허용)하기 위해 USER가 최초 로그인 시 회원 DB에 저장되는 회원의 국가 정보

...

디바이스 ID

...

  • 해당 기기를 구분할 수 있는 값을 반환하며, 기기 초기화 시 변경됩니다.

...

디바이스 모델

...

  • 현재 기기의 모델 정보를 반환합니다.

...

OS명

...

  • 현재 기기의 OS 이름(android/ios)을 반환합니다.

...

네트워크 연결 여부

...

  • 현재 기기가 외부 네트워크에 연결 되어 있는지 여부를 반환합니다.

...

연결된 네트워크 타입

...

What is System Information?

  • This API provides information about the current device.

Provided Information

Information

Meaning

Language Code

  • Retrieves the language setting information of the device, returning a value according to the ISO 639-1 standard

Country Code
(Two APIs Provided)

  • Priority for retrieving the country code

    • Priority 1) Cached country code

      • If no cached country code is available, Priority 1 is used.

    • Priority 2) GEO IP-based country code

      • Sends an asynchronous request to the server.

      • If errors "1001" or "2001" occur, an error will be raised in the start function that calls this.

      • If retrieved successfully, the information is cached.

      • In all situations where the country code cannot be retrieved properly (including when the code is "zz"), Priority 3 is used.

    • The country code follows the ISO 3166-1 alpha-2 standard, and if no country information is available, "zz" is returned.

    • The country information stored in the user’s DB at the time of the first login is used to restrict (or allow) the service range for the user and the app (game) based on geographic information (Geo IP).

    • Cached country information is reset under certain conditions. However, the country information stored in the user’s DB is only deleted upon account deletion. Therefore, after the cache is reset, the cached information will match the user’s country information upon re-login. (In the case of a new registration after account deletion, both the user DB and cached country information will be stored anew.)

  • GEO IP-based Country Code

    • The country code is returned based on the Geo IP of the network to which the device is currently connected.

    • This country information, stored in the user’s DB at the time of the first login, is used to restrict (or allow) the service range for the user and the app (game) based on geographic information (Geo IP).

Device ID

  • Returns a value that uniquely identifies the device. This value changes if the device is reset.

Device Model

  • Returns the model information of the current device.

OS Name

  • Returns the name of the current device's OS (android/ios).

Network Connection Status

  • Returns whether the current device is connected to an external network.

Connected Network Type

  • Retrieves the type of network to which the current device is connected (wifi/cellular/unknown).