속성을 이용해 내 애플리케이션 사용자의 추가 정보를 관리할 수 있습니다. 사용자 속성은 키-값 쌍입니다. SDK가 지원하는 속성 유형:

• 사용자 편집 가능 속성. 이 속성 유형의 값은 사용자가 입력하거나 클라이언트 측에서 인 게임 로직에 따라 지정합니다. 예: 이름 및 캐릭터 스탯, 게임 난이도 레벨 등등.

• 읽기 전용 속성. 이 속성 유형에 대한 값은 내 애플리케이션의 서버 측에서 입력되고 편집됩니다. 게임 캐릭터 스탯 구성 또는 많이 변경되지 않아야 하는 사용자 매개변수에 이 값을 사용하기를 권장합니다. 예: 보너스를 얻을 기회, 게임 캐릭터 키 매개변수, 사용자 카테고리, 등등에 사용할 수 있습니다.

사용자 속성을 관리하려면 다음 SDK 메소드를 사용합니다.

• GetUserAttributes — 사용자 특성 목록을 가져옵니다. Get user’s attributes from client API 호출이 SDK 메소드와 함께 사용됩니다.
• UpdateUserAttributes — 사용자 특성의 값을 업데이트합니다. Update user’s attributes from client API 호출이 SDK 메소드와 함께 사용됩니다.
• RemoveUserAttributes — 특정 ID의 사용자 특성을 제거합니다. 이는 서버 측에서 변경됩니다. Update user’s attributes from client API 호출이 SDK 메소드와 함께 사용됩니다.

읽기 전용 특성을 이용해 작업할 때 서버 토큰 또는 게시자 계정 토큰을 권한 부여용으로 사용할 수 있습니다.

게시자 계정 토큰을 가져오는 방법:

1. 게시자 계정에 들어갑니다.
2. 브라우저의 개발 도구를 통해 쿠키 파일 뷰페이지로 이동합니다.
3. pa-v4-token 매개 변수에서 값을 복사하고 Authorization 헤더에 붙여넣습니다.

사용자 계정에서 사용자가 구성할 수 있는 데이터:

• 공개 프로필 데이터:
  • 아바타
  • 별명

• 개인 사용자 데이터:
  • 성명
  • 생년월일
  • 성별
  • 전화번호
  • 이메일

API 호출을 이용해 사용자 계정을 관리할 수 있습니다. Login & Account System 자산이 보유한 구현된 메소드:

• GetUserInfo — 로컬에 캐시된 사용자 데이터를 업데이트합니다.

• UpdateUserInfo — 사용자의 이메일 주소를 가져옵니다.
• GetUserPhoneNumber — 사용자의 전화번호를 가져옵니다.
• ChangeUserPhoneNumber — 사용자의 전화번호를 업데이트합니다.
• DeleteUserPhoneNumber — 사용자의 전화번호를 삭제합니다.
• UploadUserPicture — 사용자의 아바타를 변경합니다.
• DeleteProfilePicture — 사용자의 아바타를 삭제합니다.

친구 시스템은 사용자가 서로를 찾고 소셜 연결을 설정할 수 있게 합니다. SDK가 지원하는 기능:

• 별명으로 검색
• 소셜 네트워크에서 친구 목록 가져오기
• 친구 목록 관리, 초대 전송, 친구 제거, 사용자 차단 등등
• 사용자 계정을 통한 개인 데이터 관리

친구 시스템을 구현하려면, 애플리케이션의 사용자 계정 기능을 보유해야 합니다. 이 시스템과 함께 작동하는 메소드가 이용하는 사용자 계정 매개 변수:

• 사용자 ID
• 아바타
• 닉네임

사용자는 친구 시스템의 별명을 지정하여 제대로 작동하는지 확인해야 합니다. 다음의 별명 명시 논리를 구현합니다.

• 로그인 및 비밀번호를 통한 등록에 사용된 이름을 별명으로 사용합니다.
• SNS 인증 또는 플랫폼 계정 중 별명 요청을 구현합니다.

SDK 메소드

Login & Account System 자산이 보유한 친구 시스템과 함께 작동하는 메소드:

• GetUserFriends — 로컬에 캐시된 사용자 친구 데이터를 업데이트합니다. Get user’s friends API 호출이 SDK 메소드와 함께 사용됩니다.

• UpdateUserFriends — 사용자의 소셜 연결 상태를 업데이트합니다. Update user’s friends API 호출이 SDK 메소드와 함께 사용됩니다. 소셜 연결 상태에 영향을 주는 활동:
  • 친구 요청 전송 또는 취소
  • 친구 요청 수락 또는 거절
  • 친구 목록에서 사용자 삭제
  • 사용자 차단/차단 해제

• GetUserSocialFriends — 로컬에 캐시된 사용자의 소셜 네트워크 친구 데이터를 업데이트합니다. Get social account friends API 호출이 SDK 메소드와 함께 사용됩니다.

• GetPublicInfo — 사용자의 공개 프로필에서 데이터를 가져옵니다. Get user public profile API 호출이 SDK 메소드와 함께 사용됩니다.

• SearchUsers — 별명으로 사용자를 검색합니다. Search users by nickname API 호출이 SDK 메소드와 함께 사용됩니다.

• LinkSocialProvider — 사용자 계정과 플레이어가 인증을 위해 사용하는 소녈 네트워크를 연결합니다. Link social network to user’s account API 호출이 SDK 메소드와 함께 사용됩니다.

• GetLinkedSocialProviders — 사용자의 소셜 네트워크 데이터를 업데이트합니다. Get linked networks API 호출이 SDK 메소드와 함께 사용됩니다.

• GetSocialNetworkAuthUrl — 소셜 네트워크를 플레이어의 계정에 연결하기 위해 URL을 가져옵니다. Get URL to link social network to account API 호출이 SDK 메소드와 함께 사용됩니다.

소셜 네트워크에 대한 친구 시스템 구현

귀하의 애플리케이션에서 사용자가 소셜 네트워크 친구들과 상호 작용하게 하려면 엑솔라 측에서 친구 데이터 스토리지를 구성하세요.

1. 게시자 계정으로 이동합니다.
2. 열기를 로그인 블록에서 클릭하고 로그인 프로젝트로 이동합니다.
3. 로그인 프로젝트 블록에서 열기 및 설정을 클릭합니다.
4. 일반 설정 > 인증으로 이동합니다.
5. 소셜 네트워크 친구 저장 토글을 켜짐으로 설정합니다.
6. 변경 사항을 저장합니다.

애플리케이션에서 플레이어에게 소셜 네트워크 친구들을 유효하게 하려면 귀하의 애플리케이션에 다음 논리를 구현하십시오.

1. 소셜 네트워크를 GetSocialNetworkAuthUrl 메소드를 사용해 플레이어의 계정에 연결합니다. Get URL to link social network to account API 호출이 SDK 메소드와 함께 사용됩니다.
2. UpdateUserSocialFriends 메소드를 사용해 귀하의 친구 목록을 업데이트합니다. Update social account friends API 호출이 SDK 메소드와 함께 사용됩니다.
3. 연결한 소셜 네트워크에서 친구 목록을 GetUserSocialFriends 메소드를 사용하여 가져옵니다. Get social account friends API 호출이 SDK 메소드와 함께 사용됩니다.