C2SModuleSocial_Show

개인 정보 취급 방침 및 이용 약관, 서버 점검 및 공지·업데이트 팝업을 출력한다.
초기화 이전에 안드로이드 권한을 체크할 수 있다.
requestPermission을 사용할 경우 Social Initialize 전에 호출해야 한다.

Hive SDK v1.12.0 버전부터 기존의 식별자 파라미터가 삭제되고 통합 식별자로 통일되었다.

현재 사용중인 통합 식별자 serverId와 gameLanguage는 아래 API에서 설정 가능하다.

 C2SModuleSocial_Initialize  C2SModuleSocial_SetGameInfo

Argument Type Type Description Platform 비고
type string “terms” : 개인정보 취급 방침 및 이용 약관을 출력한다.
“notice” : 서버 점검 및 공지·업데이트 팝업을 출력한다.
(1.10.0+)
“requestPermission” : [전화 걸기 및 관리] 권한을 요청한다. (Android Only) (1.11.0+)
all
type == “notice”일 때 (1.10.0+)
serverId string 서버별 점검공지 팝업지원을 위한 serverid
(백오피스 월드관리에 등록된 월드값을 서버에 따라 구분하여 입력이 되어야 한다.)
서버 지역 코드값은 ‘ISO 3166 alpha-2’ 코드를 기준으로 하며 Hive 연동 가이드라인 게임서버 ID 항목을 참고한다.
all 1.10.0+
(1.12.0+ 삭제)
type == “requestPermission”일 때 (1.11.0+)
permissionWriteExternalStorage bool (Optional) 외부저장소 권한 요청 여부 (default false) Android 1.11.0+
type == “requestPermissionList”일 때 (1.17.2+)
requests string
array
Android 위험 권한(Dangerous permissions) 요청에 따라 Android OS에서 제공하는 권한 요청 팝업 노출
앱에서 권한을 받고자하는 시점에 요청하여 사용자에게 권한을 받을 수 있다.예.
(1) 앱에서 사용할 수 있는 권한을 AndroidManifest.xml에 추가한다.
(2) requests로 요청하는 권한의 정확한 명칭 입력(string)
=> android.permission.READ_CONTACTS / android.permission.READ_PHONE_STATE / android.permission.WRITE_EXTERNAL_STORAGE 등
Android 1.17.2+

Result – Api.Social_Show

개인 정보 취급 방침 및 이용 약관 웹뷰 성공 여부
Android 권한 체크가 끝나면 반환되는 콜백

Argument Type Type Description Platform 비고
서버 점검 및 공지·업데이트 팝업 보기를 요청했을 경우 (type키가 있으면서 type == “notice”일 때)
type string “notice” : 서버 점검 및 공지·업데이트 팝업 (1.10.1+) all 1.10.1+
state string “close” : 공지 팝업 버튼이 팝업만 닫기 기능일 경우 팝업이 닫혔을 때 반환 (1.10.1+)
“unshown” : 보여줄 점검 팝업이 없는 경우 (백오피스에 등록되지 않은 상태) (1.10.1+)
all 1.10.1+
[전화 걸기 및 관리] 권한을 요청했을 경우 (type키가 있으면서 type == “requestPermission”일 때)
type string “requestPermission” : [전화 걸기 및 관리] 권한을 요청한다. Android 1.11.0+
isChecked bool requestPermission 요청시 true로 반환됨 Android 1.11.0+
[Android 권한 요청] 기능을 요청했을 경우 (type키가 있으면서 type == “requestPermissionList”일 때)
type string “requestPermissionList” : [Android 권한 요청] 기능을 요청한다. Android 1.17.2+
grantedList string
array
request로 요청한 권한 중 허용된 권한 목록 Android 1.17.2+
deniedList string
array
request로 요청한 권한 중 거부된 권한 목록 Android 1.17.2+
state string 해당 API 요청에 대한 결과

  • 0: 성공
  • -1: 일반적인 에러
  • -2: 권한 요청을 지원하지 않는 OS 버전
  • -3: requests 형식 오류
Android 1.17.2+