MSDK WIKI

개요

LBS 모듈이 플레이어의 위치 정보 및 주변 플레이어 정보를 획득할 수 있으며, 플레이어로 하여금 자신의 주변의 플레이어와 교류할 수 있게 합니다.

이미지 내 붉은 색 프레임에 관한 설명

귀하께서는 lbs 기능을 통해 주변 플레이어의 닉네임, 성별, 거리 등의 정보를 얻을 수 있습니다.

액세스 내비게이션

1 사전 요구 사항

1) 초기화 모듈 설명에 따라 초기화
2) LBS 인터페이스 호출을 이용하려면 먼저 QQ/위챗에 로그인해야 합니다.

2 콜백

개요

주변 사람의 인터페이스 WGGetNearbyPersonInfo 획득 및 자신의 위치 정보 인터페이스WGCleanLocation()를 공백으로 한 결과는, 콜백 함수 NearbyEvent를 통해 게임에 회신할 수 있습니다. 자신의 위치 정보 인터페이스 WGGetLocationInfo()의 획득 결과는 LocateEvent 콜백을 통해 게임에 회신할 수 있습니다.

자신의 위치 정보 콜백 획득

1) 기능 설명

자신의 위치 정보 콜백 획득

2) 인터페이스 선언

public delegate void LocateDelegate(LocationRet ret);

3) 파라미터 설명

반환값 명칭	파라미터 유형	설명
ret	LocationRet	플레이어 위치 정보 유형

4) 반환값

없음

5) 예시 코드

MsdkEvent.Instance.LocateEvent += (LocationRet locationret) => {
    Debug.Log(locationret.ToString());
    message = locationret.ToString();
    if (locationret.flag == eFlag.eFlag_Succ) {
        // 위치 정보 획득 성공
    } else {
        // 위치 정보 획득 실패
    }
}

6) 특수 설명

없음

7) 용어 해석

없음

주변에 있는 사람의 위치 정보 콜백 획득

1) 기능 설명

주변에 있는 사람의 위치 정보 콜백 획득

2) 인터페이스 선언

public delegate void NearbyDelegate(RelationRet ret);

3) 파라미터 설명

반환값 명칭	파라미터 유형	설명
ret	RelationRet	플레이어 정보의 통합 유형

4) 반환값

없음

5) 예시 코드

MsdkEvent.Instance.NearbyEvent += (RelationRet relationRet) => {
    Debug.Log(relationRet.ToString());
    if (relationRet.flag == eFlag.eFlag_Succ) {
        // 주변 사람 검색 성공
        //게임 TODO 주변 사람 정보 획득
    } else {
        // 주변 사람 검색 실패
        //게임 TODO 다양한 반환값에 따라 처리
    }
}

6) 특수 설명

없음

7) 용어 해석

없음

3 lbs 인터페이스 획득 정보 콜백

이때 귀하는 MSDK 인터페이스를 호출해 지리적인 위치 정보를 얻을 수 있습니다. 상세 정보는 [플레이어 위치 정보 얻기)#Unity_GetLocationInfo), [주변 사람 정보 획득)#Unity_GetNearbyPersonInfo), [위치 정보 비우기##Unity_CleanLocation)를 참조하십시오.

Lbs 기능 액세스 작업 완료를 축하드립니다!

플레이어 위치 정보 획득

1 개요 설명

플레이어 위치 정보 획득

2 콜백

콜백을 참조해 주십시오.

3 인터페이스 호출

1) 기능 설명

플레이어의 지리적 위치 정보 획득: 경도/위도.

2) 인터페이스 선언

bool WGGetLocationInfo();

3) 파라미터 설명

없음

4) 반환값

반환값이 없습니다. 획득한 결과는 를 통해 콜백 내 OnLocationGotNotify(RelationRet ret) 콜백을 등록 및 구현하며, LocationRet 반환을 보유합니다.

5) 예시 코드

WGPlatform.Instance.WGGetLocationInfo();

6) 특수 설명

없음

7) 용어 해석

없음

주변 사람 정보 획득

1 개요 설명

주변 사람 정보 획득

2 콜백

콜백을 참조해 주십시오.

3 인터페이스 호출

1) 기능 설명

현재 플레이어 주변에 있는 플레이어의 정보를 얻고, 결과 정보는 NearbyEvent가 보유하는 RelationRet에서 회신합니다.

2) 인터페이스 선언

void WGGetNearbyPersonInfo();

3) 파라미터 설명

없음

4) 반환값

반환값이 없습니다. 획득한 결과는 #등록을 통해, 콜백 ](registCallback#

5) 코드 예시:

void WGGetNearbyPersonInfo ();

6) 특수 설명

없음

7) 용어 해석

RelationRet.flag 값은 반환 상태를 나타내며, 그 값(eFlag 열거)은 다음과 같을 수 있음:

eFlag_LbsNeedOpenLocationService: 사용자가 위치 정보 서비스를 기동하도록 안내해야 합니다.
eFlag_LbsLocateFail: 위치 정보 얻기 실패, 재시도할 수 있습니다.
eFlag_Succ: 주변 사람 정보 획득
eFlag_Error:  주변 정보 획득에 성공했으나 주변 사람 정보 요청은 실패했습니다. 재시도할 수 있습니다.

RelationRet.persons는 하나의 Vector이며, 그 안에는 주변 플레이어의 정보가 저장되어 있습니다. 상세 정보는 자주 묻는 질문

위치 정보를 공백으로 두십시오.

1 개요 설명

위치 정보 인터페이스 비우기는, 자신의 위치 정보를 지울 수 있는 기능으로, 다른 플레이어가 주변 사람 정보를 얻을 때 이 플레이어의 정보는 얻을 수 없습니다.

2 콜백

콜백을 참조해 주십시오.

3 인터페이스 호출

1) 기능 설명

위치 정보 인터페이스 비우기를 호출하면, 자신의 위치 정보를 지울 수 있고 다른 플레이어가 주변 사람 정보를 얻을 때 이 플레이어의 정보는 얻을 수 없으며, 그 결과는 NearbyEvent가 보유하는 RelationRet ret에서 회신합니다.

2) 인터페이스 선언

bool WGCleanLocation();

3) 파라미터 설명

없음

4) 반환값

true 혹은 false로, 단지 서버로의 위치 삭제 요청 전송 여부를 나타냅니다. 획득한 결과는 를 통해 콜백 내 NearbyEvent 이벤트를 등록 및 구현하며, LocationRet 반환을 보유합니다.

5) 예시 코드

WGPlatform.Instance.WGCleanLocation();

6) 특수 설명

없음

7) 명칭 해석

RelationRet.flag 값은 반환 상태를 나타내며, 그 값(eFlag 열거)은 다음과 같을 수 있음:
eFlag_LbsNeedOpenLocationService: 사용자가 위치 정보 서비스를 기동하도록 안내해야 합니다.
eFlag_LbsLocateFail: 위치 정보 얻기 실패, 재시도할 수 있습니다.
eFlag_Succ: 삭제 성공