개요
공지 모듈은 MSDK에서 게임에 제공하는 정보 통지 시스템으로, MSDK 공지 관리 클라이언트를 이용해 가시적인 조작이 가능해 집니다. 공지 시스템을 통해, 귀하께서는 게임 과정에서 모든 또는 지정된 사용자에 대해 다음과 같은 이벤트 통지를 할 수 있습니다.
1) 운용 고장: 운용 과정에서 이상 상황이 발생한 경우, 귀하는 시스템을 통해 사용자에게 이상 상황을 알리고 예상되는 복원 시간을 통지할 수 있습니다.
2) 정지, 정비: 사용자에게 귀하의 정지, 정비 시간을 통지함으로써 사전에 사용자가 합리적으로 게임 시간을 계획할 수 있게 합니다.
3) 이벤트 메시지: 게임 이벤트 통지 메시지
저희가 제공하는 공지에는 다음과 같은 특징이 있습니다.
1) 정확한 타겟팅을 통한 접촉
전체 공지(모든 사용자가 수신)
구역 별 공지(지정한 대형 구역 사용자만 수신)
조작 시스템에 따른 공지(지정한 조작 시스템의 사용자만 공지를 수신하며, Android 및 iOS 시스템에 한정)
지정된 번호 공지(지정된 번호(QQ번호, 위챗 번호)만 수신)
2) 다양한 환경 지원
로그인 전 공지: 로그인 하지 않고도 전체 공지 발송 가능
로그인 후 공지: 로그인한 후에 모든 형식의 공지 발송 가능
3) 데이터 로컬라이제이션
모든 유효한 공지 클라이언트가 사전에 클라이언트에서 실행해 저장할 수 있으며, 공지 기능 사용 시에 저희가 직접 클라이언트 로컬 데이터베이스에서 귀하께서 필요로 하는 공지를 읽어 와서 표시합니다.
4) 다양한 UI 형식
팝업창 UI 공지(대화창 표시를 통해 공지 내용을 디스플레이)
스크롤 UI 공지(플로팅 윈도우 형식으로 공지 내용을 표시)
자체 정의 UI 공지(저희의 공지 데이터 베이스 디스플레이의 개성 있는 맞춤형 UI를 사용하실 수 있습니다.)
5) 다양하고 풍부한 콘텐츠
지원 콘텐츠: 문자, 이미지, 웹페이지 등 3가지 형식
다양한 형식의 공지 UI 참조사항
a) 팝업창 문자 UI 공지
b) 팝업창 이미지 UI 공지
c) 팝업창 웹페이지 UI 공지
d) 스크롤 UI 공지
이상은 모두 msdk 자체 보유 UI 공지이며, 게임에서 WGShowNotice(scene) 인터페이스를 호출하여 대응하는 공지창에 ID를 입력하면 바로 상응하는 공지를 표시할 수 있습니다.
e) 자체 정의 UI 공지
자체 정의 UI 공지를 사용해서 게임에서 WGGetNoticeData(scene)를 호출해 공지 데이터를 획득할 수 있습니다.
6) 공지 최상위 표시 기능
최상위 표시 설정이 된 공고를 우선적으로 표시합니다. 공지에 대해 최상위 표시 설정을 한 후, MSDK의 자체 공지 인터페이스를 이용해, 또는 MSDK의 공지 데이터 인터페이스 시 획득한 데이터를 사용해 아래 순서에 따라 배열할 수 있습니다.
최상위 위치 표시(우선도 가장 높음) 설정된 공지는 해당 설정이 되어있지 않은 공지(우선도 낮음)보다 앞에 표시됩니다.
같은 우선 순위의 공지(동일한 최상위 위치 표시 또는 해당 설정이 안 되어 있는)는 공지 생선 순서대로 배열되며, 생성 시간이 늦을수록 배열 위치도 더욱 앞으로 오게 됩니다.
액세스 내비게이션
1 사전 요구 사항
1) 이미 MSDK Unity 액세스 설정 모듈 설명에 따라 완료
2) 데이터 절약 업데이트 설정 스위치SAVE_UPDATE가 선택되도록 하고, 액세스 설정 Step3 설정 정보
주의사항
1) 관리 클라이언트에서 공지 설정(약 5분 후 활성화될 수 있음)
2) 게임을 기동하거나 로그인해 공지를 불러옵니다. 이 외에도, 공지 모듈에는 정해진 시간 동안 불러온 상태를 유지하는 기능(기본 10분)도 있습니다.
2 MSDK 관리 클라이언트 공지 설정
MSDK 관리 클라이언트 주소: 外网：http://open.qq.com 内网：http://dev.ied.com
MSDKDemo 공지 예시:
1) MSDK 관리 클라이언트 --> MSDK 관리 -> 공지 관리
2) 공지 관리 -> 공지(테스트 환경/정식 환경 —> 공지 추가
3) 공지 인터페이스의 입력 공지에 대응하는 파라미터를 추가하고 공지 추가 버튼을 클릭하면 공지 설정 완료
외부 네트워크 개발자는 상세한 MSDK 공지 관리 클라이언트 사용 설명을 참조하십시오.
3 클라이언트 공지 액세스
공지 액세스는 인터페이스 호출
4 Demo 예시를 참고하십시오.
예시는 Assets\Example\MsdkDemo.cs 스크립트의 ShowNotice() 메소드를 참조하십시오.
통합 및 테스트 시 주의사항
1) 클라이언트 설정 스위치 확인 MSDK_URL=http://msdktest.qq.com(선택한 환경과 관리 클라이언트 설정 공지 환경이 일치)
액세스 설정Step3 정보 설정
2) 개발 인원이 공지 관리 클라이언트에서 공지(테스트 환경)를 선택해 공지를 추가하고 통합 테스트를 실시합니다.
3) 클라이언트에서 관리 클라이언트가 설정한공지 유형(로그인 전/후, 스크롤 팝업, 번호 팩 등 테스트 여부)을 선택해 테스트를 실시하고, 공지가 표시되지 않으면, 자주 묻는 질문을 클릭해 절차에 따라 검사를 실시합니다.
공지 표시
1 개요 설명
해당 인터페이스를 호출하면 귀하께서 관리 클라이언트에서 설정한 공지를 표시할 수 있습니다.
2 콜백
없음
3 인터페이스 호출
1) 기능 설명
해당 인터페이스를 호출하면 귀하께서 관리 클라이언트에서 설정한 공지를 표시할 수 있습니다.
2) 인터페이스 선언
void WGShowNotice(string scene);3) 파라미터 설명
| 파라미터 명칭 | 유형 | 설명 |
|---|---|---|
| scene | string | 공지 필드 ID는 빈 칸이 될 수 없으며, 이 파라미터와 공지 관리 클라이언트의 “공지 필드” 설정은 대응되어야 합니다. |
4) 반환값
없음, 직접 공지 인터페이스에 표시
5) 예시 코드
string sceneString = "1";
WGPlatform.Instance.WGShowNotice(sceneString);6) 특수 설명
1) 인터페이스 호출 시에 사용한 공지 필드 id(scene) 공지 관리 클라이언트에서 **설정한 “공지 필드” ID에 대응하도록 하고, 공지 ID(msgid)로 공지 필드 ID를 대체하지 마십시오.
2) WGShowNotice 호출은 MSDK 설정의 한 세트의 인터페이스를 통해 현재 유효한 공지를 표시합니다. 팝업 공지의 경우, 이동 링크 보유 여부를 설정할 수 있고, 이동 링크를 보유한 공지는 상세 정보를 클릭하면 MSDK 내장 브라우저를 풀업해 대응하는 상세 정보 URL을 엽니다.
7) 용어 해석
없음
스크롤 공지 숨기기
1 개요 설명
이미 표시한 스크롤 공지를 숨김
2 콜백
없음
3 인터페이스 호출
1) 기능 설명
이미 표시한 스크롤 공지를 숨김
2) 인터페이스 선언
void WGHideScrollNotice();3) 파라미터 설명
없음
4) 반환값
없음, 현재 표시된 스크롤 공지 인터페이스를 숨깁니다.
- 코드 예시
WGPlatform.Instance.WGHideScrollNotice();6) 특수 설명
없음
7) 용어 해석
없음
공지 데이터 받기
1 개요 설명
로컬 데이터베이스에서 지정된 유효한 공지 데이터를 읽어와서 호출자에게 반환합니다.
2 콜백
없음
3 인터페이스 호출
1) 기능 설명
로컬 데이터베이스에서 지정된 유효한 공지 데이터를 읽어와서 호출자에게 반환합니다.
2) 인터페이스 선언
List<NoticeInfo> WGGetNoticeData(string scene);3) 파라미터 설명
| 파라미터 명칭 | 유형 | 설명 |
|---|---|---|
| scene | string | 공지 필드 ID는 빈 칸이 될 수 없으며, 이 파라미터와 공지 관리 클라이언트의 “공지 필드” 설정은 대응되어야 합니다. |
4) 반환값
List
6) 특수 설명
인터페이스 호출 시에 사용한 공지 필드 id(scene) 공지 관리 클라이언트에서 설정한 “공지 필드” ID에 대응하도록 하고, 공지 ID(msgid)로 공지 필드 ID를 대체하지 마십시오. PicInfo 내 이미지 경로는 로컬 절대 경로가 됩니다.
7) 용어 해석
없음