SDKOptions

java.lang.Object
- com.netease.nimlib.sdk.SDKOptions

public class SDKOptions
extends java.lang.Object

可自定义的 SDK 选项设置。

字段概要

字段
限定符和类型	字段和说明
`boolean`	`animatedImageThumbnailEnabled` 是否支持动态缩略图。
`java.lang.String`	`appKey` 设置云信 SDK 的 AppKey。
`boolean`	`asyncInitSDK` 是否支持异步初始化 SDK，默认同步初始化 SDK。
`AuthProvider`	`authProvider` IM 登录时的Token回调接口注意：使用动态登录（即LoginInfo.authType为1）时，必须设置
`CaptureDeviceInfoConfig`	`captureDeviceInfoConfig` 设备信息获取的配置，包括是否获取产品型号、是否获取制造商信息以及是否获取品牌信息等。
`int`	`cdnRequestDataInterval` CDN 数据上报的回调间隔时间，默认 3000ms。
`ChatRoomAuthProvider`	`chatroomAuthProvider` 聊天室登陆时的Token回调接口注意：聊天室使用动态登录（即LoginInfo.authType为1）时，必须设置
`ChatRoomLoginExtProvider`	`chatroomLoginExtProvider` 聊天室登陆时的LoginExt回调接口
`boolean`	`checkManifestConfig` 是否在 SDK 初始化时检查 Manifest 文件配置是否完成，默认为 false，不检查。
`boolean`	`clearTimeTagAtBeginning` 是否重置同步时间戳，启动时重置一次，默认为 false，即不重置。
`int`	`coreProcessStartTimeout` Core 进程启动的超时时间（单位：ms），默认为 15s。
`java.lang.String`	`customPushContentType` 离线推送不显示详情（MixPushService#setPushShowNoDetail）时，显示的自定义推送文案类型（对应控制台中的自定义推送文案类型名称）。
`java.lang.String`	`databaseEncryptKey` 数据库加密密钥，用于消息数据库加密。
`static SDKOptions`	`DEFAULT`
`boolean`	`disableAwake` 禁止后台进程唤醒 UI 进程，默认为 false。
`boolean`	`enableBackOffReconnectStrategy` 是否使用随机退避重连策略，默认为 true，开启。
`boolean`	`enableChatRoomLocation` 是否开启聊天室空间消息功能，默认为 false，即不开启。
`boolean`	`enableDatabaseBackup` 是否开启数据库备份功能，默认为 false，即不备份。
`boolean`	`enabledQChatMessageCache` 是否支持圈组消息缓存，默认为 false，即不开启。
`boolean`	`enableFcs` 是否开启融合存储，默认为 true，即开启融合存储功能。
`boolean`	`enableForegroundService` 当 NIM Service 启动失败时，是否尝试以前台服务的方式启动，默认为 false。
`boolean`	`enableLBSOptimize` 是否启用网络连接优化策略，默认为 true，开启网络链接优化策略。
`boolean`	`enableLoseConnection` 是否开启 loseConnection。
`boolean`	`enableRecentContactsTimeIndex` 是否开启最近联系人会话时间索引，默认为 false，即不开启。
`boolean`	`enableTeamMsgAck` 是否启用群消息已读功能，默认为 false，即关闭群消息已读功能。
`FcsDownloadAuthStrategy`	`fcsDownloadAuthStrategy` NOS 下载鉴权策略，用户可以自定义鉴权方式，如需使用该功能，请咨询云信技术支持。
`long`	`fetchServerTimeInterval` 获取服务器时间的连续请求间隔时间，默认 2000ms，最小 1000ms。
`boolean`	`fixMsgStatusByBlackList` 默认false，如果为true，则消息状态是否成功会结合是否被拉入黑名单进行判断
`java.lang.String`	`flutterSdkVersion` Flutter NIM SDK 的版本号。
`boolean`	`improveSDKProcessPriority` 是否提高 NIM SDK 进程优先级，默认为 true，表示提高 NIM SDK 进程优先级，可以降低 NIM SDK 核心进程被系统回收的概率。
`LogDesensitizationConfig`	`logDesensitizationConfig` /** 日志脱敏配置，即设置是否隐藏涉及下载域名地址的日志信息。
`java.lang.String`	`loginCustomTag` 登录时的自定义字段，登录成功后同步给其他端，可以通过 `AuthServiceObserver.observeOtherClients(Observer, boolean)` 获取该字段。
`LoginExtProvider`	`loginExtProvider` IM登陆时的LoginExt回调接口
`MessageNotifierCustomization`	`messageNotifierCustomization` 定制通知栏消息提醒的文案，包括內容文案（主要在通知栏下拉后展现其通知内容），Ticker文案（主要在通知栏弹框提醒时的内容）以及消息撤回时的提醒文案。
`static long`	`MIN_MSG_TYPING_EVENT_INTERVAL` 正在输入事件发送最小间隔，默认为 3000 ms。
`MixPushConfig`	`mixPushConfig` 第三方离线推送配置。
`NosTokenSceneConfig`	`mNosTokenSceneConfig` SDK 的 NOS Token 场景配置，对于 NOS Token，云信 SDK 有默认值，若用户不单独配置，则直接采用默认值。
`NotificationChannelProvider`	`notificationChannelProvider` 配置通知要走的通道（ChannelId），若不配置，则根据响铃振动走对应的默认通道。
`boolean`	`notifyStickTopSession` 是否同步置顶会话，默认为 false，即不同步置顶会话。
`boolean`	`preloadAttach` 是否需要 SDK 自动预加载多媒体消息的附件。
`boolean`	`preLoadServers` 预加载服务，默认为 true，表示开启预加载服务，预加载连接可以优化登录流程，提升用户体验。
`long`	`qChatTypingEventMinInterval` 圈组发送正在输入事件的最小间隔，默认的最小间隔为 3000ms，设置小于 3000ms无效。
`RecentContactContentSource`	`recentContactContentSource` 最近会话（RecentContact）中内容（content 字段）的来源，默认为 MessageTypeTipPreferred。
`ReconnectStrategy`	`reconnectStrategy` 自动登录失败后的重连机制。
`boolean`	`reducedIM` 是否为弱 IM 场景，默认为 false，即强 IM 场景。
`boolean`	`reportImLog` 是否开启 IM 日志自动上报，默认为 false，即不开启，若需要开启该功能，请联系云信技术支持。
`boolean`	`rollbackSQLCipher` 是否支持回滚 SQLCipher 加密的数据库，默认为 false，即不支持回滚。
`java.lang.String`	`sdkStorageRootPath` 外置存储根目录，用于存放多媒体消息文件。
`SecondTimeoutConfig`	`secondTimeoutForSendMessage` 是否配置发送消息的第二超时时间，即发送超时（对应的状态为 408）后等待回包的时间，默认为 0。
`ServerAddresses`	`serverConfig` 配置专属服务器的地址，常用于私有化部署。
`boolean`	`sessionReadAck` 是否开启会话已读多端同步，默认 false，即不支持多端同步会话未读数。
`boolean`	`shouldConsiderRevokedMessageUnreadCount` 是否需要将被撤回的消息计入未读数，默认为 false，即撤回消息不影响未读数。
`StatusBarNotificationConfig`	`statusBarNotificationConfig` 通知栏提醒功能。
`boolean`	`teamNotificationMessageMarkUnread` 群通知消息是否计入未读数，默认为 false，即默认群消息不计入未读数。
`int`	`thumbnailSize` 消息缩略图的尺寸，默认为 350 像素。
`boolean`	`useAssetServerAddressConfig` 是否检查并使用 Asset 目录下的私有化服务器配置文件 server.conf（固定命名），默认是 false，即不开启。
`boolean`	`useNtServer` 是否开启运行时的异常统计，默认开启。
`UserInfoProvider`	`userInfoProvider` 用户信息提供者，由开发者提供给 NIM SDK 使用，主要用于通知栏显示的用户昵称和头像。
`boolean`	`useXLog` 是否使用性能更好的 SDK 日志模式。

构造器概要

构造器
构造器和说明

SDKOptions()

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

方法概要
- 从类继承的方法 java.lang.Object
  clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - DEFAULT
```
public static final SDKOptions DEFAULT
```
  - appKey
```
public java.lang.String appKey
```
    设置云信 SDK 的 AppKey。
    AppKey 还可以通过在 AndroidManifest 文件中，通过 meta-data 的方式设置，如果两处都设置了，取此处的值。
    一个 AppKey 对应一个账号体系，AppKey 的取值优先级为：LoginInfo中的>SDKOptions 中的>AndroidManifest 中的 AppKey。
  - authProvider
```
public AuthProvider authProvider
```
    IM 登录时的Token回调接口注意：使用动态登录（即LoginInfo.authType为1）时，必须设置
  - loginExtProvider
```
public LoginExtProvider loginExtProvider
```
    IM登陆时的LoginExt回调接口
  - chatroomAuthProvider
```
public ChatRoomAuthProvider chatroomAuthProvider
```
    聊天室登陆时的Token回调接口注意：聊天室使用动态登录（即LoginInfo.authType为1）时，必须设置
  - chatroomLoginExtProvider
```
public ChatRoomLoginExtProvider chatroomLoginExtProvider
```
    聊天室登陆时的LoginExt回调接口
  - useAssetServerAddressConfig
```
public boolean useAssetServerAddressConfig
```
    是否检查并使用 Asset 目录下的私有化服务器配置文件 server.conf（固定命名），默认是 false，即不开启。
  - statusBarNotificationConfig
```
public StatusBarNotificationConfig statusBarNotificationConfig
```
    通知栏提醒功能。默认为 null，表示 SDK 不提供状态栏提醒功能，由用户 APP自行实现。
  - userInfoProvider
```
public UserInfoProvider userInfoProvider
```
    用户信息提供者，由开发者提供给 NIM SDK 使用，主要用于通知栏显示的用户昵称和头像。
  - messageNotifierCustomization
```
public MessageNotifierCustomization messageNotifierCustomization
```
    定制通知栏消息提醒的文案，包括內容文案（主要在通知栏下拉后展现其通知内容），Ticker文案（主要在通知栏弹框提醒时的内容）以及消息撤回时的提醒文案。
  - sdkStorageRootPath
```
public java.lang.String sdkStorageRootPath
```
    外置存储根目录，用于存放多媒体消息文件。若不设置或设置的路径不可用，将使用"external storage root/packageName/nim/"作为根目录。
  - databaseEncryptKey
```
public java.lang.String databaseEncryptKey
```
    数据库加密密钥，用于消息数据库加密。如果不设置，数据库处于明文状态；设置后，数据库会加密保存数据，之前明文保存的历史数据也会被转为加密保存。
  - preloadAttach
```
public boolean preloadAttach
```
    是否需要 SDK 自动预加载多媒体消息的附件。默认为 true，即 SDK 收到多媒体消息后，图片和视频会自动下载缩略图，音频会自动下载文件。如果关闭，第三方 APP 可以设置是否需要下载以及何时下载附件内容。
  - thumbnailSize
```
public int thumbnailSize
```
    消息缩略图的尺寸，默认为 350 像素。
    该值为最长边的大小。下载的缩略图最长边不会超过该值。
  - sessionReadAck
```
public boolean sessionReadAck
```
    是否开启会话已读多端同步，默认 false，即不支持多端同步会话未读数。
  - improveSDKProcessPriority
```
public boolean improveSDKProcessPriority
```
    是否提高 NIM SDK 进程优先级，默认为 true，表示提高 NIM SDK 进程优先级，可以降低 NIM SDK 核心进程被系统回收的概率。
  - serverConfig
```
public ServerAddresses serverConfig
```
    配置专属服务器的地址，常用于私有化部署。
  - preLoadServers
```
public boolean preLoadServers
```
    预加载服务，默认为 true，表示开启预加载服务，预加载连接可以优化登录流程，提升用户体验。不建议设置为 false。
  - teamNotificationMessageMarkUnread
```
public boolean teamNotificationMessageMarkUnread
```
    群通知消息是否计入未读数，默认为 false，即默认群消息不计入未读数。
  - useXLog
```
public boolean useXLog
```
    是否使用性能更好的 SDK 日志模式。默认为 false，即默认使用普通日志模式。
  - animatedImageThumbnailEnabled
```
public boolean animatedImageThumbnailEnabled
```
    是否支持动态缩略图。默认为 NO，即 NOS 对动图缩放流程为截取第一帧并缩放返回。
    若设置为 YES, SDK 在请求缩略图时候将直接下载动图。
  - asyncInitSDK
```
public boolean asyncInitSDK
```
    是否支持异步初始化 SDK，默认同步初始化 SDK。
  - reducedIM
```
public boolean reducedIM
```
    是否为弱 IM 场景，默认为 false，即强 IM 场景。
    如果您的应用仅需在其部分业务中使用 IM 能力（不需要在应用启动时就做 IM 自动登录），且并不需要保证消息、通知和数据的实时性的场景（例如需要用户授权隐私信息采集的业务场景），那么可填 true，使用弱 IM 场景。非弱 IM 场景慎用！
  - checkManifestConfig
```
public boolean checkManifestConfig
```
    是否在 SDK 初始化时检查 Manifest 文件配置是否完成，默认为 false，不检查。
  - mixPushConfig
```
public MixPushConfig mixPushConfig
```
    第三方离线推送配置。包括配置第三方推送证书的信息，以及是否根据token自动选择推送类型策略。
    目前 NIM SDK 支持的第三方推送厂商包括：小米、华为、荣耀、魅族、vivo、OPPO、以及谷歌 FCM。
  - enableBackOffReconnectStrategy
```
public boolean enableBackOffReconnectStrategy
```
    是否使用随机退避重连策略，默认为 true，开启。强烈建议开启。如需关闭，请咨询云信技术支持。
  - reconnectStrategy
```
public ReconnectStrategy reconnectStrategy
```
    自动登录失败后的重连机制。云信默认的自动重连策略为：自动登录失败后，默认 2 秒后触发重连，如果一直连不上，重连时间指数级增长，2、4、6、8、16、32、64...
    如果需要自行配置重连时间，可联系技术支持开启此功能进行配置。
  - enableLBSOptimize
```
public boolean enableLBSOptimize
```
    是否启用网络连接优化策略，默认为 true，开启网络链接优化策略。
  - enableTeamMsgAck
```
public boolean enableTeamMsgAck
```
    是否启用群消息已读功能，默认为 false，即关闭群消息已读功能。
  - shouldConsiderRevokedMessageUnreadCount
```
public boolean shouldConsiderRevokedMessageUnreadCount
```
    是否需要将被撤回的消息计入未读数，默认为 false，即撤回消息不影响未读数。
    客户端通常直接写入一条 Tip 消息，用于提醒"对方撤回了一条消息"，该消息也不计入未读数，不影响当前会话的未读数。
    如果设置为 true，撤回消息后未读数将减 1。
  - mNosTokenSceneConfig
```
public NosTokenSceneConfig mNosTokenSceneConfig
```
    SDK 的 NOS Token 场景配置，对于 NOS Token，云信 SDK 有默认值，若用户不单独配置，则直接采用默认值。
  - enableFcs
```
public boolean enableFcs
```
    是否开启融合存储，默认为 true，即开启融合存储功能。
    开启融合存储后，SDK 在应用收到文件消息会自动启用 CDN 加速选择最快的节点进行存储，将文件消息存储到 AWS 服务器或网易对象存储（NetEase Object Storage, NOS）服务器上。
    如果您的应用涉及海外业务，则建议开启融合存储。
  - fcsDownloadAuthStrategy
```
public FcsDownloadAuthStrategy fcsDownloadAuthStrategy
```
    NOS 下载鉴权策略，用户可以自定义鉴权方式，如需使用该功能，请咨询云信技术支持。
  - useNtServer
```
public boolean useNtServer
```
    是否开启运行时的异常统计，默认开启。
  - loginCustomTag
```
public java.lang.String loginCustomTag
```
    登录时的自定义字段，登录成功后同步给其他端，可以通过 AuthServiceObserver.observeOtherClients(Observer, boolean) 获取该字段。
  - disableAwake
```
public boolean disableAwake
```
    禁止后台进程唤醒 UI 进程，默认为 false。
  - fetchServerTimeInterval
```
public long fetchServerTimeInterval
```
    获取服务器时间的连续请求间隔时间，默认 2000ms，最小 1000ms。
  - reportImLog
```
public boolean reportImLog
```
    是否开启 IM 日志自动上报，默认为 false，即不开启，若需要开启该功能，请联系云信技术支持。
  - customPushContentType
```
public java.lang.String customPushContentType
```
    离线推送不显示详情（MixPushService#setPushShowNoDetail）时，显示的自定义推送文案类型（对应控制台中的自定义推送文案类型名称）。
  - recentContactContentSource
```
public RecentContactContentSource recentContactContentSource
```
    最近会话（RecentContact）中内容（content 字段）的来源，默认为 MessageTypeTipPreferred。
  - notifyStickTopSession
```
public boolean notifyStickTopSession
```
    是否同步置顶会话，默认为 false，即不同步置顶会话。
  - enableForegroundService
```
public boolean enableForegroundService
```
    当 NIM Service 启动失败时，是否尝试以前台服务的方式启动，默认为 false。
  - cdnRequestDataInterval
```
public int cdnRequestDataInterval
```
    CDN 数据上报的回调间隔时间，默认 3000ms。
  - rollbackSQLCipher
```
public boolean rollbackSQLCipher
```
    是否支持回滚 SQLCipher 加密的数据库，默认为 false，即不支持回滚。
  - coreProcessStartTimeout
```
public int coreProcessStartTimeout
```
    Core 进程启动的超时时间（单位：ms），默认为 15s。
  - clearTimeTagAtBeginning
```
public boolean clearTimeTagAtBeginning
```
    是否重置同步时间戳，启动时重置一次，默认为 false，即不重置。该功能不建议开启，如需开启该功能，请联系云信技术支持。
  - enableDatabaseBackup
```
public boolean enableDatabaseBackup
```
    是否开启数据库备份功能，默认为 false，即不备份。
  - captureDeviceInfoConfig
```
public CaptureDeviceInfoConfig captureDeviceInfoConfig
```
    设备信息获取的配置，包括是否获取产品型号、是否获取制造商信息以及是否获取品牌信息等。null 表示都可以获取。
    不获取设备信息可能影响 NIM SDK 功能的使用。如需使用，请联系云信技术支持。
  - secondTimeoutForSendMessage
```
public SecondTimeoutConfig secondTimeoutForSendMessage
```
    是否配置发送消息的第二超时时间，即发送超时（对应的状态为 408）后等待回包的时间，默认为 0。
    该配置属于特殊功能，如需使用该功能，请联系云信技术支持。
  - enableRecentContactsTimeIndex
```
public boolean enableRecentContactsTimeIndex
```
    是否开启最近联系人会话时间索引，默认为 false，即不开启。
  - flutterSdkVersion
```
public java.lang.String flutterSdkVersion
```
    Flutter NIM SDK 的版本号。
  - notificationChannelProvider
```
public NotificationChannelProvider notificationChannelProvider
```
    配置通知要走的通道（ChannelId），若不配置，则根据响铃振动走对应的默认通道。
  - enableChatRoomLocation
```
public boolean enableChatRoomLocation
```
    是否开启聊天室空间消息功能，默认为 false，即不开启。如需要使用该功能，请联系云信技术支持。
    SDK 在 8.11.0 中新增了空间消息能力，用于在部分基于空间坐标的场景下给指定范围内的用户发送消息，如某游戏地图内指定范围的区域。在加入聊天室时，可以预设一个坐标位置来加入房间，并且可以订阅接收多少距离内的消息。
  - MIN_MSG_TYPING_EVENT_INTERVAL
```
public static final long MIN_MSG_TYPING_EVENT_INTERVAL
```
    正在输入事件发送最小间隔，默认为 3000 ms。
    
    另请参阅:
    
    常量字段值
  - logDesensitizationConfig
```
public LogDesensitizationConfig logDesensitizationConfig
```
    /** 日志脱敏配置，即设置是否隐藏涉及下载域名地址的日志信息。
  - enableLoseConnection
```
public boolean enableLoseConnection
```
    是否开启 loseConnection。
  - qChatTypingEventMinInterval
```
public long qChatTypingEventMinInterval
```
    圈组发送正在输入事件的最小间隔，默认的最小间隔为 3000ms，设置小于 3000ms无效。
  - enabledQChatMessageCache
```
public boolean enabledQChatMessageCache
```
    是否支持圈组消息缓存，默认为 false，即不开启。
    开启消息缓存后，可以为100个频道（QChatChannel）缓存消息，每个频道最多缓存 20 条。
  - fixMsgStatusByBlackList
```
public boolean fixMsgStatusByBlackList
```
    默认false，如果为true，则消息状态是否成功会结合是否被拉入黑名单进行判断
- 构造器详细资料
  - SDKOptions
```
public SDKOptions()
```

类 SDKOptions

字段概要

构造器概要

方法概要

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

字段详细资料

DEFAULT

appKey

authProvider

loginExtProvider

chatroomAuthProvider

chatroomLoginExtProvider

useAssetServerAddressConfig

statusBarNotificationConfig

userInfoProvider

messageNotifierCustomization

sdkStorageRootPath

databaseEncryptKey

preloadAttach

thumbnailSize

sessionReadAck

improveSDKProcessPriority

serverConfig

preLoadServers

teamNotificationMessageMarkUnread

useXLog

animatedImageThumbnailEnabled

asyncInitSDK

reducedIM

checkManifestConfig

mixPushConfig

enableBackOffReconnectStrategy

reconnectStrategy

enableLBSOptimize

enableTeamMsgAck

shouldConsiderRevokedMessageUnreadCount

mNosTokenSceneConfig

enableFcs

fcsDownloadAuthStrategy

useNtServer

loginCustomTag

disableAwake

fetchServerTimeInterval

reportImLog

customPushContentType

recentContactContentSource

notifyStickTopSession

enableForegroundService

cdnRequestDataInterval

rollbackSQLCipher

coreProcessStartTimeout

clearTimeTagAtBeginning

enableDatabaseBackup

captureDeviceInfoConfig

secondTimeoutForSendMessage

enableRecentContactsTimeIndex

flutterSdkVersion

notificationChannelProvider

enableChatRoomLocation

MIN_MSG_TYPING_EVENT_INTERVAL

logDesensitizationConfig

enableLoseConnection

qChatTypingEventMinInterval

enabledQChatMessageCache

fixMsgStatusByBlackList

构造器详细资料

SDKOptions