원격 설정(Remote Settings)
Unity 프로젝트에서 원격 설정 사용

원격 설정 생성 및 변경(Creating and changing Remote Settings)

원격 설정을 사용하기 전에 Unity 프로젝트에 Unity 서비스Unity 애널리틱스 서비스를 먼저 활성화해야 합니다. 애널리틱스를 활성화한 후 애널리틱스 대시보드를 열고 Remote Settings 탭으로 이동하여 원격 설정 값을 생성하고 변경합니다. 게임 또는 애플리케이션의 원격 설정 값에 액세스하는 방법에 대해 알아보려면 Unity 프로젝트의 원격 설정 사용을 참조하십시오.

애널리틱스 서비스는 다음 두 가지 원격 설정을 제공합니다.

  1. 애널리틱스 서비스는 릴리스 설정을 애플리케이션의 일반 비개발 빌드를 실행하는 컴퓨터 또는 디바이스로 전송합니다.

  2. 애널리틱스 서비스는 개발 설정을 개발 빌드(즉, 빌드 설정 창에서 개발 빌드 플래그가 체크된 상태에서 생성된 빌드)를 실행하는 컴퓨터 및 디바이스로 전송합니다. Unity 에디터의 재생 모드는 개발 빌드로 간주됩니다.

Raging Bots라는 게임의 애널리틱스 대시보드에 있는 원격 설정 탭
Raging Bots라는 게임의 애널리틱스 대시보드에 있는 원격 설정 탭

각 원격 설정은 키, 기본값, 세그먼트 값(선택 사항)으로 구성됩니다. 설정에 세그먼트 값이 포함된 경우 현재 플레이어가 속해 있는 세그먼트에 따라 설정에 포함되는 값이 결정됩니다. 두 개 이상의 세그먼트가 해당될 경우 우선 순위가 가장 높은 세그먼트의 값이 설정에 포함됩니다.

이름 및 값 규칙 설정

개별 원격 설정은 키-값 쌍입니다. 키 이름 규칙은 다음과 같습니다.

  • 키 이름은 같은 설정 안에서는 고유해야 합니다.

  • 키 이름은 문자로 시작해야 합니다.

  • 키 이름에는 문자, 숫자, “.”, “_”, “-” 문자만 사용할 수 있습니다.

설정 값은 Int, Float, String, Bool 기본 타입 중 하나일 수 있습니다. 값 설정 규칙은 다음과 같습니다.

  • Int 값은 32비트 정수(–2147483648에서 2147483647)입니다.

  • Float 값은 단일 정밀도, 32비트 부동 소수점 숫자(약 –3.4x1038에서 3.4x1038)입니다.

  • 스트링은 1,024자로 제한됩니다.

  • “true” 또는 “false” 문자열로 부울 값을 지정해야 합니다.

원격 설정 추가

원격 설정을 추가하는 방법은 다음과 같습니다.

  1. 애널리틱스 대시보드 에서 Remote Settings 탭을 엽니다.

  2. 설정의 Configuration__에서 Release__ 또는 __Development__를 설정합니다.

  3. 설정 목록 상단에 있는 ADD NEW KEY-VALUE 를 클릭합니다.

  4. 키 이름을 입력합니다.

  5. 값 타입을 설정합니다.

  6. 기본값을 입력합니다.

  7. Save 버튼을 클릭합니다.

  8. Sync 버튼을 클릭하여 변경 사항을 퍼블리시합니다. 각 개별 설정을 생성한 후에 매번 Sync 버튼을 클릭하지 않아도 됩니다. 현재 설정에 모든 변경 사항을 적용한 후에 설정을 동기화해도 됩니다.

참고: 타겟 세그먼트가 서로 다른 값을 추가하려면 기본 키-값 설정을 저장한 다음 편집하십시오. 세그먼트 옵션은 첫 설정을 생성할 때 표시되지 않고 설정을 편집할 때만 표시됩니다.

원격 설정 편집

원격 설정을 편집하는 방법은 다음과 같습니다.

  1. Analytics 대시보드에서 Remote Settings 탭을 엽니다.

  2. Release 또는 Development Configuration 을 선택합니다.

  3. 변경할 설정 옆의 편집 아이콘을 클릭합니다.

  4. 변경 사항을 적용합니다. 키 이름을 변경하면 이전 키를 삭제하고 새로운 키를 생성하는 것과 효과가 같습니다.

  5. Save 버튼을 클릭합니다.

  6. Sync 버튼을 클릭하여 변경 사항을 퍼블리시합니다. 그 후에 플레이어가 세션을 시작하면 Unity 에디터에서 업데이트된 설정을 읽어옵니다.

동시 편집 문제 해결

팀원 두 명이 프로젝트의 원격 설정을 동시에 편집하고 수정된 설정을 서비스와 동기화하려고 하면 충돌이 발생합니다.

프로젝트를 편집하는 동안 다른 사람이 프로젝트 설정을 변경했음을 알리는 경고
프로젝트를 편집하는 동안 다른 사람이 프로젝트 설정을 변경했음을 알리는 경고

충돌이 발생하면 다음 옵션 중에서 선택할 수 있습니다.

OVERWRITE

마지막 동기화 후에 서비스에 적용된 변경 사항을 모두 폐기하고 현재 설정을 서비스로 푸시합니다. 덮어쓰기를 선택하면 서비스의 설정이 현재 설정과 정확하게 일치합니다.

MERGE

현재 설정과 서비스에서 수정된 설정을 병합하고 동기화 작업을 완료하기 전에 어떤 변경 사항을 적용할지 선택할 수 있습니다.

같은 설정 값을 편집하면 현재 수정한 변경 사항이 서비스의 버전을 덮어씁니다. 또한 서비스에서 삭제한 값과 설정이 (사용자 버전에 아직 있으므로) 복원됩니다. 그렇지 않은 경우 마지막 동기화 후에 서비스에서 변경된 사항이 유지됩니다.

병합 후에 원격 설정 페이지가 업데이트되어 병합이 반영되지만, 병합된 설정이 서버로 푸시되지는 않습니다. 업데이트된 변경 사항을 검토하고, 모든 준비가 완료되면 Sync 버튼을 다시 클릭하여 동기화할 수 있습니다.

CANCEL

동기화 작업을 취소하는 동시에 변경 사항을 적용하지 않고 충돌 다이얼로그를 닫습니다. 설정이 서비스에 저장되지 않습니다.

세그먼트마다 다른 값 추가

여러 세그먼트 값을 원격 설정 키 하나에 할당할 수 있습니다. 플레이어가 특정 값이 있는 세그먼트 중 하나에 속해 있는 경우, Unity 에디터에서 해당 값을 기본값인 All Users 값 대신 플레이어에게 전송합니다. 플레이어가 여러 세그먼트 값에 해당하는 경우 Unity 에디터에서 우선 순위가 가장 높은 세그먼트의 값을 전송합니다.

특정 세그먼트에만 해당하는 값을 설정하는 방법은 다음과 같습니다.

  1. Analytics 대시보드에서 Remote Settings 탭을 엽니다.

  2. Release 또는 Development Configuration을 선택합니다.

3, 원격 설정이 아직 없는 경우 원격 설정을 추가합니다.

  1. 설정의 맨 오른쪽에 있는 편집 아이콘을 클릭합니다.

  2. ADD EXISTING SEGMENT 를 클릭합니다.

  3. 새 행의 드롭다운 목록에서 세그먼트를 선택하고 값을 입력합니다.

  4. Save 버튼을 클릭합니다.

원격 설정 삭제

원격 설정을 삭제하려면 먼저 설정 편집 뷰를 열어야 합니다.

  1. Analytics 대시보드에서 Remote Settings 탭을 엽니다.

  2. 설정의 Configuration__에서 Release__ 또는 __Development__를 설정합니다.

  3. 삭제할 설정 옆의 편집 아이콘을 클릭하여 편집 뷰를 엽니다.

  4. 특정 세그먼트의 값을 삭제하려면 편집 뷰 오른쪽의 빼기(-) 버튼을 클릭한 다음 Save 를 클릭합니다. 기본 All Users 값은 삭제할 수 없습니다.

  5. 전체 설정을 삭제하려면 편집 뷰 하단의 삭제 아이콘을 클릭한 후 설정을 삭제하겠다고 확인합니다.

  6. Sync 버튼을 클릭하여 변경 사항을 퍼블리시합니다.

세그먼트 우선 순위 설정

플레이어가 두 개 이상의 세그먼트에 속해 있으면 Unity 에디터에서 가장 우선 순위가 높은 세그먼트에 할당된 값을 전송합니다. 설정에 세그먼트 값이 없거나 플레이어가 다른 키 값이 포함된 세그먼트에 속해 있지 않은 경우 Unity 에디터에서 All Users 값을 전송합니다. 세그먼트 순서를 설정하여 중복 값이 있는 경우 우선할 세그먼트 값을 지정할 수 있습니다.

세그먼트 우선 순위를 설정하는 방법은 다음과 같습니다.

  1. Analytics 대시보드에서 Remote Settings 탭을 엽니다.

  2. Release 또는 Development Configuration을 선택합니다.

  3. 세그먼트 우선 순위 아이콘을 클릭합니다.

  4. 현재 순서가 표시된 Segment Priority 창이 열립니다. 원격 설정 값이 이미 할당된 세그먼트만 창에 표시됩니다.

  5. 항목을 클릭하고 원하는 위치로 드래그하여 세그먼트 순서를 변경합니다.

  6. 순서가 올바르면 Save 를 클릭합니다.

  7. Sync 버튼을 클릭하여 변경 사항을 퍼블리시합니다.

세그먼트 우선 순위는 설정의 모든 설정에 적용되지만, 개발 설정과 릴리스 설정에서 우선 순위를 다르게 지정할 수 있습니다.


  • 2017–08–28 편집 리뷰 없이 페이지 수정됨

  • 2017–08–28 - 이 날짜를 기준으로 서비스가 Unity 5.5 이상 버전과 호환되지만, 버전 호환성은 변경될 수 있습니다.

  • 2017–06–30 - 키 이름에 “.”, “_” 및 “-” 기호 허용 추가

  • Unity 2017.1의 새로운 기능

  • 2017–08–28 - Unity 2017.1에서 세그먼트로 나뉜 원격 설정 추가: 세그먼트마다 다른 값 설정

원격 설정(Remote Settings)
Unity 프로젝트에서 원격 설정 사용