Android SDK基础API配置
- api列表

Android SDK基础API配置

SDK提供相关API，用于支持个性化设置，如渠道，crash收集，调试支持，日志发送策略等。

建议在调用 StatService.start(Context context)前调用。

api列表

appKey

设置appKey，可以通过如下java代码设置和获取；建议通过manifest.xml配置

// 设置appKey
StatService.setAppKey(String appKey);
// 获取appKey
StatService.getAppKey(Context context);

channelId

设置渠道，可以通过如下java代码设置和获取；建议通过manifest.xml配置

备注：历史apisetAppChannel(String appChannel)已经废弃，请使用下面新api进行渠道设置。

@param context 可以是application context
@param appChannel 渠道值，数值自定义，不同渠道自己能区分即可，例如"baidu market"
@param saveChannelWithCode 设置为true，保存设置

StatService.setAppChannel(Context context, String appChannel, boolean saveChannelWithCode) ;

crash收集

设置打开Crash日志收集。

备注：sdk 支持收集 java crash 和 native crash（底层C/C++代码崩溃）。具体native crash 收集请参考错误统计。

仅收集java crash，flag = StatService.JAVA_EXCEPTION_LOG
同时收集java 和 native crash，flag = StatService.EXCEPTION_LOG

@param context 可以是application context
@param flag crash标识

StatService.setOn(Context context, int flag);

日志延时发送

设置启动后日志发送延时时间

默认值0，启动时刻立即load数据发送日志

@param seconds 延时时长，单位：s

StatService.setLogSenderDelayed(int seconds);

session时长

设置应用进入后台再回到前台为同一次启动的最大间隔时间，有效值范围0～600s，例如设置值30s，则应用进入后台后，30s内唤醒为同一次启动

默认值 30s
启动次数定义：顾名思义，启动次数就是在规定时间段内，用户打开应用的次数。“一次启动”是指用户从打开APP开始，到退出APP（或离开应用界面，进入后台）为止。一次启动过程中可能浏览多个页面。
启动次数技术判定：如果同一个用户在退出APP或离开应用界面进入后台，又在30秒之内再次启动应用，则两次启动算作一次。反之，如果用户在30秒之后再次启动应用，则启动次数算作两次。在百度移动统计SDK3.1版本以上中，开发者都可以对“30秒”这个业界标准根据应用自身情况进行调整设定。

@param seconds 延时时长，单位：s

StatService.setSessionTimeOut(int seconds);

调试开关

设置是否打印SDK中的日志，用于调试

默认关闭；正式版本中，为避免影响APP性能，请关闭调试。

@param debug true，打开；false，关闭

StatService.setDebugOn(boolean debug);

mac id获取

设置是否采集mac地址，该接口仅对android 6 及以上版本生效。默认情况下采集macid。Macid有助于更精准的用户标识，优化报表展现。如您APP有国外发版需求，可以调用接口关闭macid获取。

如果开发者需要在google play发布，考虑到审核风险，可以调用该接口，设置为 false则不采集mac地址；设置为false后，后续新版本如果需要采集，则需要在新版本显式调用，设置为true。

@param context 可以是application context
@param debug true，打开；false，关闭

StatService.enableDeviceMac(Context context, boolean enable);

电视统计

电视统计，计算设备id的方式不同，因此需要单独打开开关

默认是标准统计，适用于手机、平板等设备；如果是电视盒子上的APP，请调用此api打开。

StatService.setForTv(Context context, boolean value) ;

自定义帐号上传

3.9.0.0版本开始，SDK支持自定义帐号上传功能。开发者上传自定义帐号后，可以在百度移动统计WEB端开启用户自定义分群功能。

设置用户id。设置后会在保存在本地，如果需要清除设置，传入null

@param context
@param userId  开发者设置的用户id

StatService.setUserId(Context context, String userId);

推送ID上传

3.9.1.0版本开始，SDK支持推送ID上传功能。开发者上传推送平台ID后，可以在百度移动统计筛选特定用户群导出推送ID列表。

设置推送平台id。设置后会在保存在本地，如果需要清除设置，传入null

@param context
@param platform 推送平台
@param pushId   客户端获取的对应推送平台的推送ID

StatService.setPushId(Context context, MtjConfig.PushPlatform platform, String pushId);

基础配置