MBNaviSession.h

浏览该文件的文档.

//
//  MBNaviSession.h
//  iNaviCore
//
//  Created by fanwei on 2/21/13.
//  Copyright (c) 2013 Mapbar. All rights reserved.
//

#import <Foundation/Foundation.h>

#import "MBNaviBaseTypes.h"
#import "MBEngine.h"

@class MBRoutePlan;
@class MBRouteBase;
@class MBRouteRequest;
@class MBNaviSessionParams;
@class MBNaviSessionData;
@class MBNaviSessionSmoothData;
@class MBRouteCollection;
@class MBHighwayGuide;
@class MBNaviLaneCollection;

@protocol MBNaviSessionDelegate;

#pragma mark - 辽宁算路需求接口

// 辽宁算路需求接口

typedef void (^LiaoNingRouteRequest)(MBRouteRequest* req,void* userdata);
typedef void (^LiaoNingRouteResponse)(NSString* response,void* userdata);

#pragma mark - 企服算路需求接口

// 企服算路需求接口

typedef void(*MBRouteResponseCallback)(const char* response, size_t responseLength, void* userdata);

typedef void(*MBRouteRequestCallback)(MBRouteRequest* request, void* userdata);


typedef NS_OPTIONS(NSUInteger, MBTmcRequest) {
    MBTmcRequest_updateRouteColors = 0x1,
    MBTmcRequest_unused = 0x2,
    MBTmcRequest_checkReroute = 0x4,
    MBTmcRequest_all = MBTmcRequest_updateRouteColors + MBTmcRequest_checkReroute
};

typedef NS_ENUM(NSInteger, MBCameraDataState) {
    //电子眼数据加载失败，或未开启电子眼模块
    MBCameraDataState_none = 0,
    //已经加载的电子眼数据为VIP数据
    MBCameraDataState_vip = 1,
    //已经加载的电子眼数据为普通版数据
    MBCameraDataState_normal = 2
};

typedef NS_ENUM(NSInteger, MBTRouterError) {
    MBERouterError_None = 0,
    MBERouterError_OriDestTooNear = 1,    
    MBERouterError_SetOriFailed = 2,      
    MBERouterError_SetDestFailed = 3,     
    MBERouterError_ComputeFailed = 4,     
    MBERouterError_MissingSubfiles = 5,   
    MBERouterError_NotEnoughMemory = 6,   
    MBERouterError_NetworkError = 7,      
    
    MBERouterError_oriNoData = 8,         
    MBERouterError_destNoData = 9,        
    MBERouterError_waypointNoData = 10,   
    
    MBERouterError_oriAuthError = 11,     
    MBERouterError_destAuthError = 12,    
    MBERouterError_waypointAuthError = 13,
    
    MBERouterError_illegalCall = 14,      
    
    MBERouterError_oriGuidMismatch = 15,     
    MBERouterError_destGuidMismatch = 16,    
    MBERouterError_waypointGuidMismatch = 17,
    
    MBERouterError_baseDataInvalidOrMissing = 18, 
    
    MBERouterError_resultTooShort = 19 
};

typedef NS_ENUM(NSInteger, MBAvoidUTurnMode) {
    //不防调头
    MBAvoidUTurnMode_disable = 0,
    //偏航多次后自动防掉头
    MBAvoidUTurnMode_auto,
    //一直防掉头(测试用，客户端一般不使用此值)
    MBAvoidUTurnMode_always,
};

typedef NS_ENUM(NSInteger, MBNaviSessionNaviStartVoiceMode) {
    MBNaviSessionNaviStartVoiceMode_detailed = 0,
    MBNaviSessionNaviStartVoiceMode_brief = 1,
    MBNaviSessionNaviStartVoiceMode_pnd = 2
};

typedef NS_ENUM(NSInteger, MBNaviSessionRouteMethod) {
    MBNaviSessionRouteMethod_single,        
    MBNaviSessionRouteMethod_multipleRule,  
    MBNaviSessionRouteMethod_multipleResult 
};

@interface MBNaviSession : NSObject
{
 @public
    LiaoNingRouteRequest _routeRequestBlock;
    LiaoNingRouteResponse _routeResponseBlock;
}
+ (instancetype)sharedInstance;
+ (void)cleanup;
@property (nonatomic, strong) MBNaviSessionParams *params;
@property (nonatomic, readonly, assign) MBSdkAuthError authErrorType;
@property (nonatomic, copy) NSString *tmcUrlBase;

@property (nonatomic, copy) NSString *tiUrlBase;
@property (nonatomic, assign) BOOL enableCamera;
@property (nonatomic, assign) BOOL customize4LiaoNing;
@property (nonatomic, weak) id<MBNaviSessionDelegate> delegate;
- (void)setTTSRole:(NSUInteger)value;
- (void)enableModule:(MBNaviSessionModule)module enable:(BOOL)enable;
- (BOOL)isModuleEnabled:(MBNaviSessionModule)module;

// 设置导航模式，在线，离线，在线优先，离线优先
@property (nonatomic, assign) MBDataPreference navPreference;

- (void)startRoute:(const MBRoutePlan *)newPlan routeMethod:(MBNaviSessionRouteMethod)method;
- (void)startRoute:(const MBRoutePlan *)newPlan avoidRoadType:(MBRouteRule)type;
- (void)cancelRouting;
- (MBRouteBase *)getRoute;
- (MBRoutePlan *)getPlan;
- (void)takeRoute:(MBRouteBase *)route;
- (void)removeRoute;
- (BOOL)isRouting;
- (NSInteger)getStepCounter;
- (BOOL)canResumeNavigation:(MBRoutePlan *)plan;
- (void)resumeNavigation;
- (NSString *)getErrorStr;
- (const void *)getNaviData __attribute__((deprecated("准备废弃此方法")));
- (void)startSimulation;
- (void)startSimulationWithPlan:(MBRoutePlan *)plan;

- (void)endSimulation;

- (BOOL)isInSimulation;

- (void)pauseSimulation;

- (void)resumeSimulation;

- (BOOL)isSimulationPaused;

- (void)setSimulationSpeed:(float)speed;

- (float)getSimulationSpeed;

- (void)enableRepeatSimulation:(BOOL)enable;

- (BOOL)isRepeatSimulationEnabled;

- (void)setSimulationInterval:(uint)milliseconds;

- (void)startRouteOverview;

- (void)endRouteOverview;

- (void)pauseNavi;

- (void)resumeNavi;

- (BOOL)isNaviPaused;

- (BOOL)isInManualStartState;

- (void)endManualStartState;
-(void)updateSessionTracking;
- (BOOL)tryGrabSegments:(MBPoint *)pos ori:(short)ori;

- (void)setRouteUrlBase:(NSString *)urlBase;

- (void)setGuidanceMode:(MBGuidanceMode)mode;

- (void)setCameraMode:(MBCameraFilterMode)mode;

@property (nonatomic, assign) MBNaviSessionNaviStartVoiceMode naviStartVoiceMode;

@property (nonatomic, readonly, strong) MBRouteCollection *routes;

@property (nonatomic, readonly, strong) MBNaviSessionData *sessionData;

@property (nonatomic, readonly, strong) MBNaviSessionSmoothData *smoothData;

- (void)disableOfflineCamera;

- (MBAuthError)getCameraAuthError __attribute__((deprecated("已废弃此方法")));

- (MBCameraDataState)getCameraDataState __attribute__((deprecated("已废弃此方法")));

- (BOOL)isVipCameraData __attribute__((deprecated("已废弃此方法")));

- (BOOL)isPositionFixed;

// 开启或者关闭各种播报语音
@property (nonatomic, assign) BOOL enableSound;

- (void)setAvoidUTurnMode:(MBAvoidUTurnMode)mode;

- (void)setReroutePreferExisting:(BOOL)prefer;
- (void)setRouteRequestCallback:(MBRouteRequestCallback)callback userdata:(void*)data;
- (void)setRouteResponseCallback:(MBRouteResponseCallback)callback userdata:(void*)data;
- (void)setRouteRequestBlock:(LiaoNingRouteRequest)requestBlock;
- (void)setRouteResponseBlock:(LiaoNingRouteResponse)responseBlock;
@end