개요
LBS 모듈이 플레이어의 위치 정보 및 주변 플레이어 정보를 획득할 수 있으며, 플레이어로 하여금 자신의 주변의 플레이어와 교류할 수 있게 합니다.
이미지 내 붉은 색 프레임에 관한 설명
귀하께서는 lbs 기능을 통해 주변 플레이어의 닉네임, 성별, 거리 등의 정보를 얻을 수 있습니다.
액세스 내비게이션
1 사전 요구 사항
1) 초기화 모듈 설명에 따라 초기화
2) LBS 인터페이스 호출을 이용하려면 먼저 QQ/위챗에 로그인해야 합니다.
2 콜백
개요
주변 사람의 인터페이스 WGGetNearbyPersonInfo 획득 및 자신의 위치 정보 인터페이스WGCleanLocation()를 공백으로 한 결과는, 콜백 함수 OnLocationNofity()를 통해 귀하께 회신할 수 있습니다. 자신의 위치 정보 인터페이스 WGGetLocationInfo()의 획득 결과는 OnLocationGotNotify() 콜백을 통해 귀하께 회신할 수 있습니다.
자신의 위치 정보 콜백 획득
1) 기능 설명
자신의 위치 정보 콜백 획득
2) 인터페이스 선언
public abstract void OnLocationGotNotify(LocationRet locationRet);3) 파라미터 설명
| 반환값 명칭 | 파라미터 유형 | 설명 |
|---|---|---|
| ret | LocationRet | 플레이어 위치 정보 유형 |
4) 반환값
없음
5) 예시 코드
@Override
public void OnLocationGotNotify(LocationRet locationRet) {
Logger.d(locationRet.toString());
String result = "flag: " + locationRet.flag + "\n" +
"platform: " + locationRet.platform + "\n" +
"longitude: " + locationRet.longitude + "\n" +
"latitude: " + locationRet.latitude;
//do some thing
}6) 특수 설명
없음
7) 명칭 해석
없음
주변에 있는 사람의 위치 정보 콜백 획득
1) 기능 설명
주변에 있는 사람의 위치 정보 콜백 획득
2) 인터페이스 선언
public abstract void OnLocationNotify(RelationRet relationRet);3) 파라미터 설명
| 반환값 명칭 | 파라미터 유형 | 설명 |
|---|---|---|
| ret | RelationRet | 플레이어 정보의 통합 유형 |
4) 반환값
없음
5) 예시 코드
void OnLocationNotify(RelationRet& relationRet) {
switch (relationRet.flag) {
case CallbackFlag.eFlag_Succ:
// p 내에 저장되는 것은 주변 플레이어 정보임
for(PersonInfo p:relationRet.persons){
String gender = p.gender;
String nickName = p.nickName;
String openId = p.openId;
String pictureLarge = p.pictureLarge;
String pictureMiddle = p.pictureMiddle;
String pictureSmall = p.pictureSmall;
//...do some thing
}
break;
default:
break;
}
}6) 특수 설명
없음
7) 명칭 해석
없음
3 lbs 인터페이스 획득 정보 콜백
이때 귀하는 MSDK 인터페이스를 호출해 지리적인 위치 정보를 얻을 수 있습니다. 상세 정보는 [플레이어 위치 정보 얻기)#Android_GetLocationInfo), [주변 사람 정보 획득)#Android_GetNearbyPersonInfo), [위치 정보 비우기##Android_CleanLocation)를 참조하십시오.
Lbs 기능 액세스 작업 완료를 축하드립니다!
플레이어 위치 정보 획득
1 개요 설명
플레이어의 지리적 위치 정보 획득: 경도/위도.
2 콜백
3 인터페이스 호출
1) 기능 설명
플레이어의 지리적 위치 정보 획득: 경도/위도.
2) 인터페이스 선언
public static bool WGGetLocationInfo();3) 파라미터 설명
없음
4) 반환값 및 콜백 설명
반환값이 없습니다. 획득한 결과는 [등록하고 콜백 )#registCallback)내 OnLocationGotNotify() 콜백을 실행하여 #Android_LocationRet)const.html#Android_LocationRet)로 회신할 수 있습니다.
5) 예시 코드
WGPlatform.WGGetLocationInfo();6) 특수 설명
없음
7) 명칭 해석
없음
주변 사람 정보 획득
1 개요 설명
현재 플레이어 주변에 있는 플레이어의 정보를 획득합니다.
2 콜백
3 인터페이스 호출
1) 기능 설명
현재 플레이어 주변에 있는 플레이어의 정보를 얻고, 결과 정보는 OnLocationNotify(RelationRet ret) 콜백을 통해 RelationRet로 회신합니다.
2) 인터페이스 선언
public static void WGGetNearbyPersonInfo();3) 파라미터 설명
없음
4) 반환값
반환값이 없습니다. 획득한 결과는 [등록을 통해, 콜백 )#registCallback)내 주변 사람의 정보는 OnLocationNotify(RelationRet ret)을 보유한 #Android_LocationRet)const.html#Android_RelationRet)을 통해 귀하께 회신할 수 있습니다.
5) 코드 예시:
WGPlatform.WGGetNearbyPersonInfo();6) 특수 설명
없음
7) 명칭 해석
RelationRet.flag 값은 반환 상태를 나타내며, 그 값(eFlag 열거)은 다음과 같을 수 있음:
eFlag_LbsNeedOpenLocationService: 사용자가 위치 정보 서비스를 기동하도록 안내해야 합니다.
eFlag_LbsLocateFail: 위치 정보 얻기 실패, 재시도할 수 있습니다.
eFlag_Succ: 주변 사람 정보 획득
eFlag_Error: 주변 정보 획득에 성공했으나 주변 사람 정보 요청은 실패했습니다. 재시도할 수 있습니다.RelationRet.persons는 하나의 Vector이며, 그 안에는 주변 플레이어의 정보가 저장되어 있습니다. 상세 정보는 자주 묻는 질문
위치 정보를 공백으로 두십시오.
1 개요 설명
위치 정보 인터페이스 비우기는, 자신의 위치 정보를 지울 수 있는 기능으로, 다른 플레이어가 주변 사람 정보를 얻을 때 이 플레이어의 정보는 얻을 수 없습니다.
2 콜백
3 인터페이스 호출
1) 기능 설명
위치 정보 인터페이스 비우기를 호출하면, 자신의 위치 정보를 지울 수 있고 다른 플레이어가 주변 사람 정보를 얻을 때 이 플레이어의 정보는 얻을 수 없으며, 그 결과는 OnLocationNotify(RelationRet ret) 콜백이 보유하는 RelationRet을 통해 회신합니다.
2) 인터페이스 선언
public static boolean WGCleanLocation()3) 파라미터 설명
없음
4) 반환값
반환값이 없습니다. 획득한 결과는 를 통해 내 OnLocationGotNotify(RelationRet ret) 콜백을 등록 및 구현하며, RelationRet 반환을 보유합니다.
5) 예시 코드
WGPlatform.WGCleanLocation();6) 특수 설명
없음
7) 명칭 해석
RelationRet.flag 값은 반환 상태를 나타내며, 그 값(eFlag 열거)은 다음과 같을 수 있음:
eFlag_LbsNeedOpenLocationService: 사용자가 위치 정보 서비스를 기동하도록 안내해야 합니다.
eFlag_LbsLocateFail: 위치 정보 얻기 실패, 재시도할 수 있습니다.
eFlag_Succ: 삭제 성공