CameraSystem (JNaviCore SDK Documentation)

java.lang.Object
- com.mapbar.navi.CameraSystem

```
public class CameraSystem
extends java.lang.Object
```
电子眼模块控制器
用于设置电子眼播报模式等相关信息，并在导航过程中获取前方的电子眼，用于显示

嵌套类概要

嵌套类
限定符和类型	类和说明
`class`	`CameraSystem.CameraEvent`
`static interface`	`CameraSystem.CameraEventHandler`
`class`	`CameraSystem.ErrorCode` 电子眼错误码
`class`	`CameraSystem.FilterMode`

字段概要

字段
限定符和类型字段和说明

static int MAX_USER_CAMERA_NUMBER
用户自定义电子眼上限

字段
限定符和类型	字段和说明
`static int`	`MAX_USER_CAMERA_NUMBER` 用户自定义电子眼上限

构造器概要

构造器
构造器和说明

CameraSystem()

构造器
构造器和说明
`CameraSystem()`

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static void`	`addEventHandler(CameraSystem.CameraEventHandler eventHandler)` 设置Camera事件监听者
`static int`	`addUserCamera(UserCameraData data)` 添加自定义电子眼，应该保证电子眼数据base.cmr或base.ca2存在且获得授权
`static void`	`enableVoice(boolean enable)` 是否播报电子眼的语音
`static CameraData[]`	`getCameras()` 获取前方道路中的电子眼，如果前方无电子眼，那么返回0个元素的数组。
`static UserCameraData`	`getUserCamera(int index)` 根据下标获取用户自定义电子眼
`static int`	`getUserCameraNum()` 获取用户自定义电子眼个数
`static UserCameraData[]`	`getUserCameras(int start, int number)` 根据范围获取用户自定义电子眼，例如，获取全部电子眼时参数为(0, `getUserCameraNum()`)
`static void`	`removeEventHandler(CameraSystem.CameraEventHandler eventHandler)` 移除外部监听者
`static boolean`	`removeUserCamera(int index)` 通过索引删除自定义电子眼
`static boolean`	`removeUserCameraById(int id)` 通过ID删除自定义电子眼
`static int`	`replaceUserCamera(int index, UserCameraData data)` 根据索引替换自定义电子眼
`static boolean`	`saveUserCamera2File()` 将添加的电子眼数据保存到文件中
`static void`	`setCameraFilterDistance(int distance)` 设置获取自车位置前方多少m范围内的电子眼，默认2000m
`static void`	`setFilter(int[] types, boolean broadcast)` 设置播报/不播报特定类型的电子眼
`static void`	`setFilterMode(int mode)` 设置播报模式，一般推荐设置为标准模式 e.g.

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - MAX_USER_CAMERA_NUMBER
```
public static final int MAX_USER_CAMERA_NUMBER
```
    用户自定义电子眼上限
    
    另请参阅:
    
    常量字段值
- 构造器详细资料
  - CameraSystem
```
public CameraSystem()
```
- 方法详细资料
  - addEventHandler
```
public static void addEventHandler(CameraSystem.CameraEventHandler eventHandler)
```
    设置Camera事件监听者
    
    参数:
    
    eventHandler - 外部Camera事件监听者
  - removeEventHandler
```
public static void removeEventHandler(CameraSystem.CameraEventHandler eventHandler)
```
    移除外部监听者
    
    参数:
    
    eventHandler - 外部监听者
  - setFilterMode
```
public static void setFilterMode(int mode)
```
    设置播报模式，一般推荐设置为标准模式
    e.g. CameraSystem.setFilterMode(CameraSystem.FilterMode.simple);
    
    参数:
    
    mode - The CameraSystem.FilterMode
    
    另请参阅:
    
    CameraSystem.FilterMode
  - setFilter
```
public static void setFilter(int[] types,
                             boolean broadcast)
```
    设置播报/不播报特定类型的电子眼
    
    参数:
    
    types - 电子眼类型CameraType数组，传null表示全部类型
    
    broadcast - true表示播报指定的类型，false表示不播报
    
    Notice:
    
    1.效果和setFilterMode(int)类似，后设置的起作用
    2.效果可叠加，在前一次设置的效果基础上修改，比如
    setFilter(new int[]{CameraType.speed, CameraType.light , true)，播报限速和摄像头
    setFilter(new int[]{CameraType.light , false)，在上次设置的基础上修改，只播报限速
  - enableVoice
```
public static void enableVoice(boolean enable)
```
    是否播报电子眼的语音
    
    参数:
    
    enable - 如果为true，表示正常播报，如果为false，那么只显示不播报语音
  - getCameras
```
public static CameraData[] getCameras()
```
    获取前方道路中的电子眼，如果前方无电子眼，那么返回0个元素的数组。 Get the cameras on the road ahead.
    
    返回:
    
    All the cameras, if the number is zero, it will return a zero length array.
  - setCameraFilterDistance
```
public static void setCameraFilterDistance(int distance)
```
    设置获取自车位置前方多少m范围内的电子眼，默认2000m
    
    参数:
    
    distance - 离自车位置的距离，单位m
  - getUserCameraNum
```
public static int getUserCameraNum()
```
    获取用户自定义电子眼个数
    
    返回:
    
    用户自定义电子眼个数
  - getUserCamera
```
public static UserCameraData getUserCamera(int index)
```
    根据下标获取用户自定义电子眼
    
    参数:
    
    index - 下标
    
    返回:
    
    如果电子眼存在返回电子眼数据，否则返回null
  - getUserCameras
```
public static UserCameraData[] getUserCameras(int start,
                                              int number)
```
    根据范围获取用户自定义电子眼，例如，获取全部电子眼时参数为(0, getUserCameraNum())
    
    参数:
    
    start - 开始位置
    
    number - 个数
    
    返回:
    
    用户自定义电子眼数组
  - addUserCamera
```
public static int addUserCamera(UserCameraData data)
```
    添加自定义电子眼，应该保证电子眼数据base.cmr或base.ca2存在且获得授权
    
    返回:
    
    错误码CameraSystem.ErrorCode，如果添加成功返回CameraSystem.ErrorCode.noError
  - removeUserCamera
```
public static boolean removeUserCamera(int index)
```
    通过索引删除自定义电子眼
    
    参数:
    
    index - 索引值
    
    返回:
    
    是否删除成功，true表示删除成功，false表示失败
    
    Notice:
    
    删除电子眼后，电子眼的数量会减少，若在循环中删除电子眼，循环条件应类似于 for(int i = num - 1; i >= 0; i--) { ... }
  - removeUserCameraById
```
public static boolean removeUserCameraById(int id)
```
    通过ID删除自定义电子眼
    
    参数:
    
    id - 自定义电子眼ID
    
    返回:
    
    是否刪除成功，true表示删除成功，false表示删除失败
  - replaceUserCamera
```
public static int replaceUserCamera(int index,
                                    UserCameraData data)
```
    根据索引替换自定义电子眼
    
    参数:
    
    index - 索引
    
    data - 替换数据
    
    返回:
    
    错误码，如果返回CameraSystem.ErrorCode.noError表示删除成功
  - saveUserCamera2File
```
public static boolean saveUserCamera2File()
```
    将添加的电子眼数据保存到文件中

类 CameraSystem

嵌套类概要

字段概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

字段详细资料

MAX_USER_CAMERA_NUMBER

构造器详细资料

CameraSystem

方法详细资料

addEventHandler

removeEventHandler

setFilterMode

setFilter

enableVoice

getCameras

setCameraFilterDistance

getUserCameraNum

getUserCamera

getUserCameras

addUserCamera

removeUserCamera

removeUserCameraById

replaceUserCamera

saveUserCamera2File