ICellbatchingInterface

概述

定义对基站轨迹数据记录模块进行基本操作的接口。

接口包含注册回调函数,取消注册回调函数,使能和去使能基站轨迹数据记录,主动获取基站轨迹数据。

Since:

4.0

Since:

4.0

相关模块:

HdiLpfenceCellbatching

汇总

Public 成员函数

名称 描述
RegisterCellbatchingCallback ([in] ICellbatchingCallback callbackObj) 注册回调函数。
UnregisterCellbatchingCallback ([in] ICellbatchingCallback callbackObj) 取消注册回调函数。
CellbatchingSwitch ([in] struct CellbatchingRequest req) 打开/关闭基站轨迹数据记录。
FlushCellbatching () 上报缓存的基站轨迹数据。

成员函数说明

CellbatchingSwitch()

ICellbatchingInterface::CellbatchingSwitch ([in] struct CellbatchingRequest req)

描述:

打开/关闭基站轨迹数据记录。

功能打开后,会将设备接收到的基站数据进行缓存,若接收到的基站数据与上一次接收的数据相同,则不会进行此次的数据缓存。

参数:

名称 描述
req 设置基站轨迹数据记录参数。详见CellbatchingRequest

返回:

如果操作成功,则返回0。

如果操作失败,则返回负值。

FlushCellbatching()

ICellbatchingInterface::FlushCellbatching ()

描述:

上报缓存的基站轨迹数据。

上报基站数据的个数与设备的缓存buffer大小、设备接收的基站数据个数有关。flush之后,底层缓存基站数据会被清空。

返回:

如果操作成功,则返回0。

如果操作失败,则返回负值。

RegisterCellbatchingCallback()

ICellbatchingInterface::RegisterCellbatchingCallback ([in] ICellbatchingCallback callbackObj)

描述:

注册回调函数。

用户在开启基站轨迹数据记录功能前,需要先注册该回调函数。当应用主动获取基站轨迹数据时,会通过回调函数进行上报。

参数:

名称 描述
callbackObj 要注册的回调函数,只需成功订阅一次,无需重复订阅。详见ICellbatchingCallback

返回:

如果注册回调函数成功,则返回0。

如果注册回调函数失败,则返回负值。

UnregisterCellbatchingCallback()

ICellbatchingInterface::UnregisterCellbatchingCallback ([in] ICellbatchingCallback callbackObj)

描述:

取消注册回调函数。

取消之前注册的回调函数。当应用不需要使用基站轨迹数据记录功能,或需要更换回调函数时,需要取消注册回调函数。

参数:

名称 描述
callbackObj 要取消注册的回调函数,只需成功取消订阅一次,无需重复取消订阅。详见ICellbatchingCallback

返回:

如果取消注册回调函数成功,则返回0。

如果取消注册回调函数失败,则返回负值。