인증 #

플레이어를 사용자로 설정하기, 다른 플레이어와 소통하기와 같이 멀티플레이어 게임에서 중요한 기능에 대해서 먼저 살펴보겠습니다.

Nakama를 사용하여 데이터가 저장되고 처리되는 중앙 집중식 서버를 쉽게 생성하고 플레이어(클라이언트)를 서버에 연결할 수 있습니다.

연결 설정 #

여기서 Unity 클라이언트와 Nakama 서버를 연결합니다.

첫 번째 단계는 게임이 Unity에서 시작되면 새로운 클라이언트 개체를 등록하는 것입니다. 이 개체는 클라이언트와 서버 사이에서 모든 상호 작용을 위한 인터페이스로 사용됩니다.

아래 항목은 클라이언트를 초기화하는 메인 메뉴 스크립트의 조각입니다:

Scene01MainMenuController.cs

1
2

var client = new Client("http", "localhost", 7350, "defaultkey", UnityWebRequestAdapter.Instance);
client.Timeout = 5;

여기서, 다음의 연결 값을 전달하여 로컬로 시작한 서버(http://localhost:7350에서 사용 가능)로 연결을 생성합니다:

• Scheme: 연결 구성표는 http 여기를 참조하십시오.
• Host: 서버 호스트 localhost의 예시입니다.
• Port: 서버 포트는 기본적으로 7350(으)로 설정됩니다.
• ServerKey: 기본적으로, defaultkey이(가) 사용됩니다. 서버 구성을 통해 변경할 수 있습니다.

장치 인증 #

서버 연결을 완료하고 플레이어 인증을 진행하여 플레이어의 신원과 연결될 수 있도록 합니다.

Pirate Panic을 시작할 경우, 자동으로 인증이 완료되고 사용자 이름이 지정됩니다. 전화기 또는 컴퓨터 등 게임을 실행하는 장치와 연결되는 계정을 생성하는 장치 인증에서 원활한 인증이 진행됩니다.

Unity에서 장치 인증은 장치 ID를 AuthenticateDeviceAsync(으)로 전달하여 완료됩니다:

1
2

string deviceId = SystemInfo.deviceUniqueIdentifier;
session = await client.AuthenticateDeviceAsync(deviceId);

인증이 완료된 경우, 플레이어는 로그인 시간을 표시하는 세션에 참여합니다. 자세한 내용은 세션을 참조하십시오.

세션 개체는 Socket와(과) Account 개체를 주로 사용하여 인증된 클라이언트로서 요청 사항을 전달하고 사용자 정보에 액세스할 수 있습니다:

1
2
3

var socket = client.NewSocket(useMainThread: true);
await socket.ConnectAsync(session);
account = await client.GetAccountAsync(session);

Pirate Panic에서 client, socket, account, session 속성은 GameConnection 개체에 저장됩니다. 향후에 _connection(으)로 액세스하는 경우, 해당 속성을 참조한다는 점을 기억하시기 바랍니다.

Facebook 인증 #

장치 인증을 사용하면 플레이어가 쉽게 게임에 바로 진입할 수 있지만, 장치에 계정을 연결한 상태에서 장치가 손실 또는 재설정될 경우 계정이 소실됩니다. Facebook과 같은 외부 소셜 공급자를 통해 사용자 계정에 연결하면 추가적인 사용자 정보를 사용하여 문제를 해결할 수 있습니다.

Facebook SDK를 장면 스크립트에 포함시켜 다음과 같이 초기화합니다:

1
2
3
4
5
6
7
8

using Facebook.Unity;
..
private void InitializeFacebook() {
    FB.Init(() =>
    {
        FB.ActivateApp();
    });
}

그런 다음, 아래의 조각이 로그를 처리합니다:

ProfileUpdatePanel.cs

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

private void LinkFacebook()
{
    List<string> permissions = new List<string>();
    permissions.Add("public_profile");

    FB.LogInWithReadPermissions(permissions, async result =>
    {
        string facebookToken = result.AccessToken.TokenString;
        await _connection.Client.AuthenticateFacebookAsync(facebookToken);
    });
}

여기서 public_profile 권한을 제공하여 Nakama를 통해 이름 또는 프로필 사진과 같은 기본적인 사용자 정보에 액세스할 수 있습니다. Facebook SDK 문서에서 참조할 수 있는 다른 권한과 기능도 추가할 수 있습니다.

Facebook에 로그인하면 플레이어의 Facebook 친구들이 게임 내의 친구 목록에 자동으로 추가됩니다.

새로운 플레이어 초기화 #

플레이어가 로그인을 완료한 다음에는 초기 플레이어 정보를 설정해야 합니다. 이 작업이 완료되면, 플레이어는 친구를 추가하고, 보석을 모으고, 퀘스트를 완료하거나 사용자 데이터를 저장할 수 있습니다.

이 작업은 등록 후크를 사용하여 서버 측에서 처리할 수 있습니다. 인증 메서드마다 후크가 다릅니다. 예를 들어, 장치와 Facebook 인증을 설정하기 때문에 registerAfterAuthenticateDevice와(과) registerAfterAuthenticateFacebook을(를) 사용해야 합니다.

후크가 트리거될 때 실행되는 함수와 연결할 수 있습니다.

main.ts

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

initializer.registerAfterAuthenticateDevice(afterAuthenticateDeviceFn);

const afterAuthenticateDeviceFn: nkruntime.AfterHookFunction<nkruntime.Session, nkruntime.AuthenticateDeviceRequest> = function(ctx: nkruntime.Context, logger: nkruntime.Logger, nk: nkruntime.Nakama, data: nkruntime.Session, req: nkruntime.AuthenticateDeviceRequest) {
    afterAuthenticate(ctx, logger, nk, data);

    if (!data.created) {
        return; // Account already exists.
    }
    ...
    // Player initialization goes here. Write initial stats, add items to inventory, etc.
}

세션 토큰 #

보안상의 이유로 Nakama 구성에서 정의된 시간이 지나면 플레이어 세션이 자동으로 만료됩니다. 플레이어가 다시 로그인하지 않아도 되도록 기존 세션이 만료되기 전에 새로운 세션을 자동으로 요청할 수 있게 메서드를 설정할 수 있습니다.

이 작업은 클라이언트에서 인증 토큰을 저장하고 서버에 새로운 토큰을 정기적으로 요청하여 처리할 수 있습니다.

두 가지 유형의 토큰이 있습니다:

• 액세스 토큰: 클라이언트의 신원을 서버에 알려주고 해당 클라이언트를 신뢰할 수 있도록 합니다.
• 새로 고침 토큰: 새로운 액세스 토큰을 요청할 때 사용합니다.

Nakama의 경우, client 개체를 사용하여 SessionRefreshAsync(으)로 새로운 토큰을 요청할 수 있습니다:

Scene01MainMenuController.cs

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

string authToken = PlayerPrefs.GetString("nakama.authToken", null);
string refreshToken = PlayerPrefs.GetString("nakama.refreshToken", null);

session = Session.Restore(authToken, refreshToken);

// Check whether a session is close to expiry.
if (session.HasExpired(DateTime.UtcNow.AddDays(1))) {
    try {
        // get a new access token
        session = await client.SessionRefreshAsync(session);
    } catch (ApiResponseException) {
        // get a new refresh token
        session = await client.AuthenticateDeviceAsync(deviceId);
        PlayerPrefs.SetString("nakama.refreshToken", session.RefreshToken);
    }

    PlayerPrefs.SetString("nakama.authToken", session.AuthToken);
}

여기서는, Unity의 내장된 PlayerPrefs 엔진을 사용하여 액세스 토큰과 새로 고침 토큰을 각각 nakama.authToken와(과) nakama.refreshToken에 저장합니다. 세션 만료 전까지 하루 미만 남아있는 경우, 스크립트는 SessionRefreshAsync을(를) 사용하여 새로운 액세스 토큰을 요청합니다. 새로 고침 토큰이 유효하지 않은 경우, 해당 작업은 실패하고 모든 작업을 다시 인증해야 합니다.

다음 주제 #

친구 및 채팅

Related Pages

• GameConnection.cs
• Scene01MainMenuController.cs
• ProfileUpdatePanel.cs
• Server main.ts