UGS 시작하기
Learn how to set up Unity Gaming Services in your project.
읽는 시간 2분최근 업데이트: 10시간 전
여기에서는 Unity Gaming Services를 사용하도록 프로젝트를 설정하는 방법을 설명합니다.
필수 조건
아직 하지 않았다면 다음을 완료한 후 온보딩 프로세스를 시작하십시오.- Unity 계정을 만듭니다.
- 가격 책정 및 과금에 대해 알아봅니다.
Unity 엔진을 사용하는 게임
Unity 프로젝트에서 UGS를 사용하려면 다음을 수행합니다.- 새 Unity Cloud 프로젝트를 생성합니다.
- 필요한 UGS 패키지를 설치합니다.
- SDK의 네임스페이스를 임포트합니다.
- 게임 코드에서 UGS를 초기화합니다.
- 첫 번째 Cloud Code 스크립트를 생성합니다.
REST API를 사용하는 게임
다른 게임 엔진을 사용하는 경우 REST API를 사용하여 게임에 UGS를 구현할 수 있습니다. UGS 사용을 시작하려면 다음을 수행합니다. Unreal Engine을 사용하는 경우 다음을 사용하여 일부 UGS 기능을 게임에 구현할 수 있습니다.- Unreal Engine용 Unity Gaming Services SDK를 사용하여 다음을 구현합니다.
- Vivox Unreal SDK
Unity Hub에서 프로젝트 생성
새로운 Unity Cloud 연결 프로젝트를 생성하는 가장 빠른 방법은 Unity Hub를 사용하는 것입니다.- Unity Hub에서 New project를 선택합니다.
- Unity 조직을 포함하여 필요한 필드를 입력합니다.
- Connect to Unity Cloud 체크박스가 선택되어 있어야 합니다.
Unity Dashboard에서 프로젝트 생성
Unity Dashboard에서 프로젝트와 서비스를 관리할 수 있습니다. 새 프로젝트를 생성하려면 다음을 수행합니다.- 기본 내비게이션 메뉴에서 Projects를 선택합니다.
- Projects 페이지 오른쪽 상단에서 New를 선택합니다.
- 프로젝트 이름과 COPPA 설정을 입력합니다.
- Create를 선택합니다.
Unity 에디터에서 프로젝트 연결
Unity Gaming Services를 사용하려면 Unity 에디터의 프로젝트를 Unity Cloud 프로젝트에 연결해야 합니다. 에디터에서 프로젝트를 연결하려면 다음을 수행합니다.- Edit > Project Settings > Services를 선택합니다.
- Use an existing Unity project ID를 선택합니다.
- 드롭다운 메뉴에서 조직과 프로젝트를 선택합니다.
- Link project ID를 선택합니다.
UGS 패키지 설치
프로젝트에 구현하려는 서비스에 해당하는 패키지를 설치합니다. UGS에 적용되는 패키지를 보고 설치하려면 다음을 수행합니다.- Unity 에디터에서 Window > Package Manager를 선택합니다.
- Package Manager에서 Unity Registry 목록 뷰를 선택합니다.
- 패키지 이름을 검색하거나 레지스트리 목록에서 이름을 찾습니다.
- 패키지를 선택하고 Install을 클릭합니다.
SDK 네임스페이스 임포트
SDK용 API에 액세스하려면 스크립트에서 SDK의 네임스페이스를 임포트해야 합니다. 예를 들어, Analytics의 경우 다음을 수행합니다.using Unity.Services.Analytics;
게임 코드에서 Unity 서비스 초기화
Services Core SDK를 초기화한 다음 서비스 기능을 호출해야 합니다. 권장되는 방식은 게임 런타임 초반에, 가능하다면 실행 시 서비스를 초기화하는 것입니다.
게임 코드에서 Unity 서비스를 초기화하려면 Services Core 네임스페이스(예:
Unity.Services.CoreInitializeAsync이 메서드는 프로젝트에 설치된 모든 Unity Gaming Services를 초기화합니다.using System;using Unity.Services.Core;using UnityEngine;public class InitializationExample : MonoBehaviour{ async void Awake() { try { await UnityServices.InitializeAsync(); } catch (Exception e) { Debug.LogException(e); } }}
State첫 번째 Cloud Code 스크립트 생성 및 그 이후
커스텀 서버 권한이 있는 경제 로직 또는 게임 로직은 Unity Gaming Services에서 가장 일반적으로 사용되는 방법 중 하나입니다. 이 Cloud Code 가이드에는 설치, 초기화, 대시보드 구성, 게임 클라이언트에서 간단한 Cloud Code 스크립트를 원격으로 실행하는 방법까지 시작에 필요한 모든 내용이 포함되어 있습니다.다음 단계
- UGS 기능을 활용하는 방법에 대한 아이디어를 얻으려면 Unity의 사용 사례 샘플 프로젝트를 참고하십시오.
- 개별 서비스를 구현합니다.
- UGS CLI 또는 Deployment 창을 사용하여 구성 관리 워크플로를 간소화합니다.