함수 링크 복사
naviView
를 생성합니다.
- (id) | initWithGuidance: | (KNGuidance *_Nonnull) | aGuidance |
trip: | (KNTrip *_Nullable) | aTrip | |
routeOption: | (KNRoutePriority) | aRouteOption | |
avoidOption: | (KNRouteAvoidOption) | aAvoidOption |
- aGuidance
- 길 안내 기능 및 경로 정보
- aTrip
- 주행에 사용할 경로
- aRouteOption
- 길 안내 선정 시 우선적 고려할 사항
- aAvoidOption
- 경로에서 회피하고 싶은 구간
야간 모드를 설정합니다.
- (void) | useDarkMode: | (BOOL) | aMode |
소리의 볼륨을 설정합니다.
- (void) | sndVolume: | (float) | aVolume |
- aVolume
- 볼륨 설정(범위: 0~1.0f)
차량에 사용되는 연료를 설정합니다.
- (void) | fuelType: | (KNCarFuel) | aFuelType |
차량의 종류를 변경합니다.
- (void) | carType: | (KNCarType) | aCarType |
naviView
를 해제합니다.
- (void) | releaseView |
길 안내를 시작합니다. KNGuidance
의 가이던스 상태 델리게이트(guideStateDelegate
)에 의해 호출되는 guidanceGuideStated()
의 내용을 KNNaviView
에 전달합니다.
- (void) | guidanceGuideStarted: | (KNGuidance *_Nonnull) | aGuidance |
- aGuidance
- 길 안내 기능 및 경로 정보
경로의 변화를 감지합니다. 교통 변화, 경로 이탈로 인한 경로 재탐색이나 사용자가 경로를 재탐색할 때 호출됩니다.
KNGuidance
의 가이던스 상태 델리게이트(guideStateDelegate
)에 의해 호출되는 guidanceCheckingRouteChange()
의 내용을 KNNaviView
에 전달합니다.
- (void) | guidanceCheckingRouteChange: | (KNGuidance *_Nonnull) | aGuidance |
- aGuidance
- 길 안내 기능 및 경로 정보
기존 경로를 유지합니다. 교통 변화를 감지한 뒤 경로 변화가 없거나, 교통 상황의 변화로 요청한 새로운 경로가 기존의 경로와 동일할 경우 호출됩니다.
KNGuidance
의 가이던스 상태 델리게이트(guideStateDelegate
)에 의해 호출되는 guidanceRouteUnchanged()
의 내용을 KNNaviView
에 전달합니다.
- (void) | guidanceCheckingRouteChange: | (KNGuidance *_Nonnull) | aGuidance |
- aGuidance
- 길 안내 기능 및 경로 정보
경로 요청에 실패 시 에러 메시지를 반환합니다.
KNGuidance
의 가이던스 상태 델리게이트(guideStateDelegate
)에 의해 호출되는 guidanceRouteUnchangedWithError()
의 내용을 KNNaviView
에 전달합니다.
- (void) | guidance: | (KNGuidance *_Nonnull) | aGuidance |
routeUnchangedWithError: | (KNError *_Nonnull) | aError |
- aGuidance
- 길 안내 기능 및 경로 정보
- aError
- 경로 요청 실패 에러
기존 경로를 이탈합니다.
KNGuidance
의 가이던스 상태 델리게이트(guideStateDelegate
)에 의해 호출되는 guidanceOutOfRoute()
의 내용을 KNNaviView
에 전달합니다.
- (void) | guidanceOutOfRoute: | (KNGuidance *_Nonnull) | aGuidance |
- aGuidance
- 길 안내 기능 및 경로 정보
경로 변경를 전달합니다. 여러 개의 경로 중 첫 번째 경로가 주행 경로이며 나머지는 대안 경로가 됩니다.
KNGuidance
의 가이던스 상태 델리게이트(guideStateDelegate
)에 의해 호출되는 guidanceRouteChanged()
의 내용을 KNNaviView
에 전달합니다.
- (void) | guidanceOutOfRoute: | (KNGuidance *_Nonnull) | aGuidance |
- aGuidance
- 길 안내 기능 및 경로 정보
길 안내가 종료됩니다. KNGuidance
의 가이던스 상태 델리게이트(guideStateDelegate
)에 의해 호출되는 guidanceGuideEnded()
의 내용을 KNNaviView
에 전달합니다. 길 안내 종료를 안내하는 팝업 메시지 표시 여부 설정도 할 수 있습니다.
- (void) | guidanceGuideEnded: | (KNGuidance *_Nonnull) | aGuidance |
isShowDriveResultDialog: | (BOOL) | aIsShow; |
- aGuidance
- 길 안내 기능 및 경로 정보
- aIsShow
- 길 안내 종료 팝업 메시지 표시 여부
기존 경로가 변경됩니다.
KNGuidance
의 가이던스 상태 델리게이트(guideStateDelegate
)에 의해 호출되는 guidanceDidUpdateRoutes()
의 내용을 KNNaviView
에 전달합니다.
- (void) | guidance: | (KNGuidance *_Nonnull) | aGuidance |
didUpdateRoutes: | (NSArray<KNRoute*> *) | aRoutes | |
multiRouteInfo: | (KNMultiRouteInfo *_Nullable) | aMultiRouteInfo |
- aGuidance
- 길 안내 기능 및 경로 정보
- aRoutes
- 경로 정보 목록
- aMultiRouteInfo
- 대안 경로 정보
위치 정보를 업데이트합니다.
KNGuidance
의 가이던스 상태 델리게이트(guideStateDelegate
)에 의해 호출되는 guidanceDidUpdateLocation()
의 내용을 KNNaviView
에 전달합니다.
- (void) | guidance: | (KNGuidance *_Nonnull) | aGuidance |
didUpdateLocation: | (KNGuide_Location *_Nonnull) | aLocationGuide |
- aGuidance
- 길 안내 기능 및 경로 정보
- aLocationGuide
- 위치 정보
경로 안내 정보의 상세 항목 중 한 개 이상의 항목이 변경될 때 전달됩니다.
KNGuidance
의 가이던스 상태 델리게이트(guideStateDelegate
)에 의해 호출되는 guidanceDidUpdateRouteGuide()
의 내용을 KNNaviView
에 전달합니다.
- (void) | guidance: | (KNGuidance *_Nonnull) | aGuidance |
didUpdateRouteGuide: | (KNGuide_Route *_Nonnull) | aRouteGuide |
- aGuidance
- 길 안내 기능 및 경로 정보
- aRouteGuide
- 경로 안내 정보
안전 운행 안내 정보의 상세 항목 중 한 개 이상의 항목이 변경될 때 전달됩니다.
KNGuidance
의 가이던스 상태 델리게이트(guideStateDelegate
)에 의해 호출되는 guidanceDidUpdateSafetyGuide()
의 내용을 KNNaviView
에 전달합니다.
- (void) | guidance: | (KNGuidance *_Nonnull) | aGuidance |
didUpdateSafetyGuide: | (KNGuide_Safety *_Nonnull) | aSafetyGuide |
- aGuidance
- 길 안내 기능 및 경로 정보
- aSafetyGuide
- 안전 운행 안내 정보
주변의 안전 운행 정보 데이터를 전달합니다.
KNGuidance
의 가이던스 상태 델리게이트(guideStateDelegate
)에 의해 호출되는 guidanceDidUpdateAroundSafeties()
의 내용을 KNNaviView
에 전달합니다.
- (void) | guidance: | (KNGuidance *_Nonnull) | aGuidance |
didUpdateAroundSafeties: | (NSArray<__kindofKNSafety*> *_Nullable) | aSafeties |
- aGuidance
- 길 안내 기능 및 경로 정보
- aSafeties
- 안전 운행 정보 리스트
음성 안내 재생 여부를 반환합니다. NO
반환 시 음성 안내가 재생되지 않습니다.
KNGuidance
의 가이던스 상태 델리게이트(guideStateDelegate
)에 의해 호출되는 shouldPlayVoiceGuide()
의 내용을 KNNaviView
에 전달합니다.
길 안내 중 백그라운드 모드로 전환 시 음성 안내는 종료되지 않습니다.
- (BOOL) | guidance: | (KNGuidance *_Nonnull) | aGuidance |
shouldPlayVoiceGuide: | (KNGuide_Voice *) | aVoiceGuide | |
replaceSndData: | (NSData **) | aNewData |
- aGuidance
- 길 안내 기능 및 경로 정보
- aVoiceGuide
- 음성 안내 정보
- aNewData
- 기존 음성을 대체할 새로운 음성 데이터 리스트
음성 안내를 재생합니다.
KNGuidance
의 가이던스 상태 델리게이트(guideStateDelegate
)에 의해 호출되는 willPlayVoiceGuide()
의 내용을 KNNaviView
에 전달합니다.
- (void) | guidance: | (KNGuidance *_Nonnull) | aGuidance |
willPlayVoiceGuide: | (KNGuide_Voice *_Nonnull) | aVoiceGuide |
- aGuidance
- 길 안내 기능 및 경로 정보
- aVoiceGuide
- 음성 안내 정보
음성 안내를 종료합니다.
KNGuidance
의 가이던스 상태 델리게이트(guideStateDelegate
)에 의해 호출되는 didFinishPlayVoiceGuide()
의 내용을 KNNaviView
에 전달합니다.
- (void) | guidance: | (KNGuidance *_Nonnull) | aGuidance |
didFinishPlayVoiceGuide: | (KNGuide_Voice *_Nonnull) | aVoiceGuide |
- aGuidance
- 길 안내 기능 및 경로 정보
- aVoiceGuide
- 음성 안내 정보
안전 운행을 취소하고 새로운 길 안내를 시작합니다.
- (void) | guideNewDestinations: | (KNTrip *_Nonnull) | aTrip |
priority: | (KNRoutePriority) | aPriority | |
avoidOptions: | (SInt32) | aAvoidOptions; |
- aTrip
- 길 안내할 경로
- aPriority
- 경로 탐색 우선순위 옵션
- aAvoidOptions
- 경로 탐색 제한 옵션
길 안내를 종료하고 안전 운행 모드로 전환합니다.
- (void) | guideCancel; |