MBCameraEngine.h

浏览该文件的文档.

//
//  MBCameraEngine.h
//  iNaviCore
//
//  Created by renzc on 2017/12/5.
//  Copyright © 2017年 Mapbar. All rights reserved.
//

#import <Foundation/Foundation.h>
#import "MBNaviBaseTypes.h"
@class MBUserCamera;

typedef NS_ENUM(NSInteger, MBUserCameraErrorCode) {
    MBUserCameraErrorCode_none = 0,
    MBUserCameraErrorCode_fileNotExist,            // 用户自定义电子眼文件不存在
    MBUserCameraErrorCode_indexInvalid,            // 无效的索引，超出自定义电子眼数目上限，或者小于-1
    MBUserCameraErrorCode_full,                    // 自定义电子眼已满
    MBUserCameraErrorCode_grabRoadFailed,            // 自定义电子眼抓路失败
    MBUserCameraErrorCode_cameraRepeat,            // 在附近发现另一个用户自定义电子眼
    MBUserCameraErrorCode_IdInvalid,                // 无效的UserCamera id
    MBUserCameraErrorCode_positionInvalid,        // 非法坐标
    MBUserCameraErrorCode_typeInvalid,            // 非法类型
};

/*
 *  电子眼检测到超速   lSpeed：电子眼限速 cSpeed：当前车速
 */
typedef void (^MBCameraEngineOverSpeedBlock)(CGFloat lSpeed, CGFloat cSpeed);
/*
 *  刚播过的电子眼信息   text：刚播过的电子眼,文字 distance：播报时，车距离起点的距离
 */
typedef void (^MBCameraEngineBroadcastTextBlock)(NSString *text, NSInteger distance);

@interface MBCameraEngine : NSObject

@property (nonatomic, copy) MBCameraEngineOverSpeedBlock overSpeedBlock;
@property (nonatomic, copy) MBCameraEngineBroadcastTextBlock broadCastTextBlock;

+ (instancetype)sharedCameraEngine;

- (void)disableOfflineCamera;
- (BOOL)offlineDataAvaliable;
/*
 *  获取当前活跃的电子眼(在自车前方，将要或已经播报)
 */
- (NSArray *)cameras;
/*
 *  设置播报模式
 */
- (void)setFilterMode:(MBCameraFilterMode)mode;
- (void)setFilterWithCameraType:(MBCameraType *)types number:(NSInteger)num enable:(BOOL)on;

/*
 *  语音开关
 */
- (void)enableVoice:(BOOL)enable;
- (BOOL)voiceEnabled;

/*
 *  超速播报开关
 */
- (void)enableSpeedingWarning:(BOOL)enable;
- (BOOL)speedingWarningEnabled;

/*
 *  重置 在导航结束时调用，结束播报
 */
- (void)reset;

/*
 *  用户自定义电子眼管理接口
 */
- (NSArray *)userCameras;
- (void)removeAllUserCameras;
- (MBUserCamera *)userCameraAtIndex:(NSUInteger)index;
- (MBUserCameraErrorCode)addUserCamera:(MBUserCamera *)camera;
- (MBUserCameraErrorCode)replaceUserCameraAtIndex:(NSUInteger)index userCamera:(MBUserCamera *)camera;
- (BOOL)removeUserCameraAtIndex:(NSUInteger)index;
- (BOOL)removeUserCameraById:(NSUInteger)cameraId;

- (BOOL)userCameraFileValid;
- (BOOL)openUserCameraFile:(NSString *)fileName;
- (BOOL)saveUserCamerasToFile;
@end