엔진 공통
Hive SDK 인증 기능을 사용하기 위해 모든 개발 엔진에서 필요한 설정을 안내합니다.
Hive 콘솔 설정¶
Hive SDK 인증을 사용하려면, 먼저 Hive 콘솔 앱센터에서 AppID별로 IdP를 위한 설정을 진행해야 합니다.
Note
더 자세한 내용은 인증 v4 IdP 설정을 확인하세요.
hive_config.xml 설정¶
hive_config.xml 파일에 사용하려는 IdP에 따라 인증 설정을 추가합니다.
Note
hive_config.xml 설정에 관한 자세한 내용은 다음을 참고하세요.
항목 | 설명 |
---|---|
providers | 서드 파티 라이브러리에 대한 속성값을 지정합니다. |
providers 요소에 속하는 요소로, 인증 v4로 인증할 때 사용하는 Facebook 관련 설정을 정의합니다. Facebook SDK를 사용할 때 Hive SDK에서 기본으로 설정하는 email 권한(Facebook 계정 이메일 주소 접근)과 public_profile(Facebook 공개 프로필 접근) 권한 외에 추가 권한이 필요하다면, Facebook 콘솔에서 해당 권한을 요청한 후 hive_config.xml에 요소로 추가해야 합니다. Hive SDK v4 Unity Windows 사용 시 Facebook 로그인을 구현하려면, 이 요소 내에 `id` 속성을 추가하고 속성값으로 앱 ID를 입력해야 합니다. 앱 ID는 앱을 만든 후에 Meta 앱 대시보드에서 확인할 수 있습니다. | |
providers 요소에 속하는 요소로, 인증 v4로 인증할 때 사용하는 Google 관련 설정을 추가합니다. 데스크톱에서 Google 로그인을 구현하려면, 이 요소 내에 `clientId` 속성을 추가하고 속성값으로 Google Cloud Console에서 발급받은 Client ID를 입력해야 합니다. Steam Deck에서 Google 로그인을 구현하려면(Hive SDK v4 Unity Windows 22.0.0 이상), 이 요소 내에 `deviceFlowClientId` 속성을 추가하고 속성값으로 Google Cloud Console에서 발급받은 Client ID를 입력해야 합니다. | |
providers 요소에 속하는 요소로, 인증 v4로 인증할 때 사용하는 WeChat 관련 설정을 추가합니다. | |
providers 요소에 속하는 요소로, 인증 v4로 인증할 때 사용하는 QQ 관련 설정을 추가합니다. | |
vk | providers 요소에 속하는 요소로, 인증 v4로 인증할 때 사용하는 VK 관련 설정을 추가합니다. |
line | providers 요소에 속하는 요소로, 인증 v4로 인증할 때 사용하는 LINE 관련 설정을 추가합니다. |
weverse | providers 요소에 속하는 요소로, 인증 v4로 인증할 때 사용하는 Weverse 관련 설정을 추가합니다. |
signinwithapple | providers 요소에 속하는 요소로, 인증 v4로 인증할 때 사용하는 Sign-in-with-Apple 관련 설정을 추가합니다. (Android, Windows에서 Apple 계정으로 로그인할 때 사용합니다.) (+4.15.6) Android, Windows에서 Sign-in-with-Apple 로그인을 구현하려면, 이 요소 내에 `serviceid` 속성을 추가하고 속성값으로 Apple 개발자 센터에서 발급받은 Services ID를 입력해야 합니다. |
<properties>
<providers>
<!-- 아래 Facebook 코드는 Hive SDK에서 자동으로 설정하는 email 권한, public_profile 권한 외에 다른 권한들(예를 들면 user_friends, user_gender)이 추가로 필요할 때 이를 위해 설정하는 예시입니다.-->
<!-- 실제로 hive_config.xml을 사용할 때에는, 게임사가 필요로 하는 권한만을 <permission> 요소로 삽입해야 합니다. -->
<facebook id="1809615065921877">
<permissions>
<permission name="user_friends" />
<permission name="user_gender" />
</permissions>
</facebook>
<google playAppId="123456789012" clientId="123456789012-abc.apps.googleusercontent.com" serverClientId="123456789012-abc.apps.googleusercontent.com" reversedClientId="com.googleusercontent.apps.123456789012-abc" deviceFlowClientId="331526026701-gn1abq1ev23nqj7rdvvlaamf7ii4f3u9.apps.googleusercontent.com" />
<googleplaygames playAppId="123456789012" clientId="123456789012-abc.apps.googleusercontent.com" serverClientId="123456789012-abc.apps.googleusercontent.com" reversedClientId="com.googleusercontent.apps.123456789012-abc" />
<qq id="1234567890" />
<vk id="1234567" />
<wechat id="wx12345cf6c789c0f1" secret="abcdefg" univeralLink="https://your.sample.com/"/>
<line channelId="1234567890" />
<weverse clientId="abcdefg" />
<!-- (Android Only) 애플 개발자 계정에서 설정한 서비스 id를 serviceid로 설정 -->
<signinwithapple serviceid="com.sample.your" />
</providers>
</properties>