nim-web-sdk-ng

import { V2NIMChatroomInfo } from '.'; import { V2NIMChatroomUpdateParams, V2NIMChatroomtagsUpdateParams } from './V2NIMChatroomInfoService'; import { V2NIMLoginAuthType } from './V2NIMChatroomLoginService'; import { V2NIMChatroomMember, V2NIMChatroomMemberListResult, V2NIMChatroomMemberQueryOption, V2NIMChatroomMemberRole, V2NIMChatroomMemberRoleUpdateParams, V2NIMChatroomSelfMemberUpdateParams, V2NIMChatroomTagMemberOption } from './V2NIMChatroomMemberService'; import { V2NIMChatroomMessage, V2NIMChatroomMessageListOption, V2NIMChatroomTagMessageOption, V2NIMSendChatroomMessageParams, V2NIMSendChatroomMessageResult, V2NIMMessageCustomAttachmentParser } from './V2NIMChatroomMessageService'; import { NIMEBaseServiceInterface, V2NIMAntispamConfig } from './types'; import { NIMAppServiceRegion, NIMEStrAnyObj } from '../../types'; export interface V2NIMChatroomService extends NIMEBaseServiceInterface<V2NIMChatroomListener> { /** * 更新聊天室信息 * @example * ```ts * await chatroom.V2NIMChatroomService.updateChatroomInfo({ name: "新聊天室名" }) * ``` */ updateChatroomInfo(updateParams: V2NIMChatroomUpdateParams, antispamConfig?: V2NIMAntispamConfig): Promise<void>; /** * 更新聊天室位置信息 * @example * ```ts * await chatroom.V2NIMChatroomService.updateChatroomLocationInfo({ x: 100, y: 200 }) * ``` */ updateChatroomLocationInfo(locationConfig: V2NIMChatroomLocationConfig): Promise<void>; /** * 更新聊天室标签 * @example * ```ts * await chatroom.V2NIMChatroomService.updateChatroomTags({ tags: ["tag1", "tag2"] }) * ``` */ updateChatroomTags(updateParams: V2NIMChatroomtagsUpdateParams): Promise<void>; /** * 发送消息接口 * * 注: 消息通过 chatroom.V2NIMChatroomMessageCreator 创建, 参见 {@link V2NIMChatroomMessageCreator | V2NIMChatroomMessageCreator} * @example * ```ts * const message = chatroom.V2NIMChatroomMessageCreator.createTextMessage("Hello") * const result = await chatroom.V2NIMChatroomService.sendMessage(message) * ``` */ sendMessage(message: V2NIMChatroomMessage, params?: V2NIMSendChatroomMessageParams, progress?: (percentage: number) => void): Promise<V2NIMSendChatroomMessageResult>; /** * 取消文件类消息的附件上传 * * 注: 若成功取消, 则算为消息发送失败处理 * * @param message 需要取消附件上传的消息体 * @example * ```ts * await chatroom.V2NIMChatroomService.cancelMessageAttachmentUpload(message) * ``` */ cancelMessageAttachmentUpload(message: V2NIMChatroomMessage): Promise<void>; /** * 注册自定义消息附件解析器，解析 {@link V2NIMMessageType.V2NIM_MESSAGE_TYPE_CUSTOM | V2NIMMessageType.V2NIM_MESSAGE_TYPE_CUSTOM} 类消息的附件 * * 注: 可以注册多个解析器, 后注册的优先级高，优先派发. 一旦某一个解析器返回了一个合法的 attachment 附件对象(即携带 raw 属性的一个对象)，则不继续派发给下一个解析器. * * @param parser 解析器 * @example * ```ts * chatroom.V2NIMChatroomService.registerCustomAttachmentParser((raw) => ({ raw, customData: JSON.parse(raw) })) * ``` */ registerCustomAttachmentParser(parser: V2NIMMessageCustomAttachmentParser): void; /** * 反注册自定义消息附件解析器 * * 注: 要传递 registerCustomAttachmentParser 所注册的, 引用页相同的那个 parser 解析器, 才能正确反注册. * * @param parser 解析器函数 * @example * ```ts * chatroom.V2NIMChatroomService.unregisterCustomAttachmentParser(myParser) * ``` */ unregisterCustomAttachmentParser(parser: V2NIMMessageCustomAttachmentParser): void; /** * 查询历史消息 * * @param option 查询条件 * @example * ```ts * const messages = await chatroom.V2NIMChatroomService.getMessageList({ limit: 50 }) * ``` */ getMessageList(option: V2NIMChatroomMessageListOption): Promise<V2NIMChatroomMessage[]>; /** * 分页获取聊天室成员列表 * @param option 参数 * @example * ```ts * const result = await chatroom.V2NIMChatroomService.getMemberListByOption({ limit: 50 }) * ``` */ getMemberListByOption(option: V2NIMChatroomMemberQueryOption): Promise<V2NIMChatroomMemberListResult>; /** * 根据标签查询消息列表 * * @param messageOption 查询参数 * @example * ```ts * const messages = await chatroom.V2NIMChatroomService.getMessageListByTag({ tag: "tag1", limit: 50 }) * ``` */ getMessageListByTag(messageOption: V2NIMChatroomTagMessageOption): Promise<V2NIMChatroomMessage[]>; /** * 更新聊天室成员角色 * @example * ```ts * await chatroom.V2NIMChatroomService.updateMemberRole("accountId1", { memberRole: 1 }) * ``` */ updateMemberRole(accountId: string, updateParams: V2NIMChatroomMemberRoleUpdateParams): Promise<void>; /** * 设置聊天室成员黑名单状态 * * 注: 必须为创建者或者管理员才能设置. 如果目标是管理员，则仅创建者可以设置 * * @param accountId 被操作的账号 ID * @param blocked 黑名单状态 * @param notificationExtension 本次操作生成的通知中的扩展字段 * @example * ```ts * await chatroom.V2NIMChatroomService.setMemberBlockedStatus("accountId1", true) * ``` */ setMemberBlockedStatus(accountId: string, blocked: boolean, notificationExtension?: string): Promise<void>; /** * 设置聊天室成员禁言状态 * * 注: 必须为创建者或者管理员才能设置. 如果目标是管理员，则仅创建者可以设置 * * @param accountId 被操作的账号 ID * @param blocked 禁言状态 * @param notificationExtension 本次操作生成的通知中的扩展字段 * @example * ```ts * await chatroom.V2NIMChatroomService.setMemberChatBannedStatus("accountId1", true) * ``` */ setMemberChatBannedStatus(accountId: string, chatBanned: boolean, notificationExtension?: string): Promise<void>; /** * 设置成员临时禁言状态 * * @param accountId 被操作的账号 ID * @param tempChatBannedDuration 设置临时禁言时长, 单位: 秒. 最大设置为 30 天. 取消则设置为 0 * @param notificationEnabled 是否需要通知 * @param notificationExtension 本次操作生成的通知中的扩展字段 * @example * ```ts * await chatroom.V2NIMChatroomService.setMemberTempChatBanned("accountId1", 3600, true) * ``` */ setMemberTempChatBanned(accountId: string, tempChatBannedDuration: number, notificationEnabled: boolean, notificationExtension?: string): Promise<void>; /** * 更新自己在聊天室的成员信息 * * @param updateParams 更新参数 * @param antispamConfig 反垃圾配置 * @example * ```ts * await chatroom.V2NIMChatroomService.updateSelfMemberInfo({ roomNick: "新昵称" }) * ``` */ updateSelfMemberInfo(updateParams: V2NIMChatroomSelfMemberUpdateParams, antispamConfig?: V2NIMAntispamConfig): Promise<void>; /** * 根据账号列表查询成员信息 * * 注: 单次查询不能超过 200 个 * * @param accountIds 账号 ID 列表 * @example * ```ts * const members = await chatroom.V2NIMChatroomService.getMemberByIds(["accountId1", "accountId2"]) * ``` */ getMemberByIds(accountIds: string[]): Promise<V2NIMChatroomMember[]>; /** * 踢出聊天室成员 * @param accountId 被踢人的账号 id * @param notificationExtension 本次操作生成的通知中的扩展字段 * @example * ```ts * await chatroom.V2NIMChatroomService.kickMember("accountId1") * ``` */ kickMember(accountId: string, notificationExtension?: string): Promise<void>; /** * 按聊天室标签临时禁言 * * 注: 只有管理员或创建者可以操作 * @param params 参数 * @example * ```ts * await chatroom.V2NIMChatroomService.setTempChatBannedByTag({ tag: "tag1", duration: 3600 }) * ``` */ setTempChatBannedByTag(params: V2NIMChatroomTagTempChatBannedParams): Promise<void>; /** * 根据 tag 查询群成员列表 * * @param option 参数 * @example * ```ts * const result = await chatroom.V2NIMChatroomService.getMemberListByTag({ tag: "tag1" }) * ``` */ getMemberListByTag(option: V2NIMChatroomTagMemberOption): Promise<V2NIMChatroomMemberListResult>; /** * 查询某个标签下的成员人数 * @param tag 标签 * @example * ```ts * const count = await chatroom.V2NIMChatroomService.getMemberCountByTag("tag1") * ``` */ getMemberCountByTag(tag: string): Promise<number>; } export interface V2NIMChatroomListener { /** * 本端发送消息状态回调 * * 开发者通过监听 sendingState, 以及 attachmentUploadState 状态，可以实现消息发送状态的监听 */ onSendMessage: [message: V2NIMChatroomMessage]; /** * 收到新消息 */ onReceiveMessages: [messages: V2NIMChatroomMessage[]]; /** * 消息撤回回调 * * @param messageClientId 被撤回的消息的 ID * @param messageTime 被撤回的消息的时间 */ onMessageRevokedNotification: [messageClientId: string, messageTime: number]; /** * 聊天室成员进入 * * @param member 加入聊天室的用户 */ onChatroomMemberEnter: [member: V2NIMChatroomMember]; /** * 聊天室成员离开 * * @param member 退出聊天室的用户 */ onChatroomMemberExit: [accountId: string]; /** * 成员角色更新 */ onChatroomMemberRoleUpdated: [previousRole: V2NIMChatroomMemberRole, currentMember: V2NIMChatroomMember]; /** * 自己被加入黑名单. (实际调试压根收不到这个消息) */ /** * 成员信息更新 */ onChatroomMemberInfoUpdated: [member: V2NIMChatroomMember]; /** * 自己禁言状态变更 * * @param chatBanned 禁言状态 */ onSelfChatBannedUpdated: [chatBanned: boolean]; /** * 自己的临时禁言状态变更 * * @param tempChatBanned 临时禁言状态 * @param tempChatBannedDuration 临时禁言时长 */ onSelfTempChatBannedUpdated: [tempChatBanned: boolean, tempChatBannedDuration: number]; /** * 聊天室信息更新 * * @param chatroomInfo 更新后的聊天室信息 */ onChatroomInfoUpdated: [chatroomInfo: V2NIMChatroomInfo]; /** * 聊天室整体禁言状态更新。服务器 API。操作者必须是管理员或者创建者 * * @param chatBanned 禁言状态 */ onChatroomChatBannedUpdated: [chatBanned: boolean]; /** * 更新角色标签 */ onChatroomTagsUpdated: [tags: Array<string>]; } export declare const enum V2NIMChatroomStatus { /** * 聊天室断开连接 */ V2NIM_CHATROOM_STATUS_DISCONNECTED = 0, /** * 聊天室等待重连 */ V2NIM_CHATROOM_STATUS_WAITING = 1, /** * 聊天室连接过程中 */ V2NIM_CHATROOM_STATUS_CONNECTING = 2, /** * 聊天室已连接 */ V2NIM_CHATROOM_STATUS_CONNECTED = 3, /** * 聊天室进入中 */ V2NIM_CHATROOM_STATUS_ENTERING = 4, /** * 聊天室已进入 */ V2NIM_CHATROOM_STATUS_ENTERED = 5, /** * 聊天室已退出 */ V2NIM_CHATROOM_STATUS_EXITED = 6 } /** * 新建实例时，传入 appkey。除web端外，其它端新建实例时，通过 SDK 初始化传入参数 * * 后续这个属性还会加入更多配置参数 */ export interface V2NIMChatroomInitParams { /** * 应用 appkey */ appkey: string; /** * App 服务区域。未持久化 LBS 服务区域时，用于聊天室内置 default link 区域兜底。 * * 可选值：NIMAppServiceRegionUnspecified、NIMAppServiceRegionCN、NIMAppServiceRegionSG */ appServiceRegion?: NIMAppServiceRegion; /** * 聊天室 LBS 完整地址列表。 * * 当 `enter` 传入 `enableLbs=true` 时，SDK 会优先使用这里配置的地址发起聊天室 LBS 请求； * 若这些地址全部失败，SDK 会进入 `linkProvider` / `chatroomLinkList` 降级链路，不再继续尝试 SDK 内置默认 LBS 地址。 * * 需要传入带路径的完整请求地址，例如 ['https://lbs.netease.im/lbs/chat.jsp'] * * 若不传, SDK 默认会提供一个 ['https://lbs.netease.im/lbs/chat.jsp'] * * 注: 小程序环境下，SDK 会识别 `/lbs/chat.jsp` 并替换为 `/lbs/wxchat.jsp` */ chatroomLbsList?: string[]; /** * 聊天室长连接兜底地址列表。 * * 当 `enableLbs=true` 时，它在 `LBS -> linkProvider` 之后作为最终兜底地址来源； * * 当 `enableLbs=false` 时，SDK 会忽略该配置，并回退到原有 `linkProvider` 机制 */ chatroomLinkList?: string[]; /** * 自定义客户端类型 */ customClientType?: number; /** * @Multi_Lang_Tag * @locale cn * 日志分级 * * 可选值，"off" | "error" | "warn" | "log" | "debug" * @locale * * @locale en * Log classification * * Available values, "off" | "error" | "warn" | "log" | "debug" * @locale */ debugLevel?: DebugLevel; /** * 是否固定设备 ID */ isFixedDeviceId?: boolean; loginSDKTypeParamCompat?: boolean; /** * 是否采用二进制的形式传输数据，默认为 true */ binaryWebsocket?: boolean; /** * 是否启用网络可达性探测上报。默认 true。 * * 注: 该能力仅用于在 chatroomLogin、LinkKeep 等 SDK 数据上报中追加 net_probe 字段， * 不会改变连接、心跳、断线或重连行为。设置为 false 时，SDK 不读取网络探测 ABTest 配置、 * 不发起探测请求，也不追加 net_probe。 */ networkProbeEnable?: boolean; } export interface V2NIMOtherParams { /** * @Multi_Lang_Tag * @locale cn * cloud storage 模块配置 * @locale * * @locale en * cloud storage config * @locale */ cloudStorageConfig?: NIMEModuleParamCloudStorageConfig; /** * @Multi_Lang_Tag * @locale cn * SDK 上报收集数据的配置 * * 注: v1.0.0 开始支持 * @locale * * @locale en * Data reporting config * @locale */ reporterConfig?: NIMOtherOptionsReporterConfig; /** * @Multi_Lang_Tag * @locale cn * ABtest 配置 * * 注: v1.0.0 开始支持 * @locale * * @locale en * ABTest configuration * @locale */ abtestConfig?: NIMOtherOptionsAbtestConfig; /** * 日志模块的配置 */ loggerConfig?: NIMOtherOptionsLoggerConfig; /** * 本地反垃圾词库的配置 */ V2NIMClientAntispamUtilConfig?: NIMOtherOptionsAntispamUtilConfig; /** * 私有化配置. v10.9.50+ 支持 */ privateConf?: NIMOtherOptionsPrivateConfig; } export declare type NIMOtherOptionsPrivateConfig = { /** * 上传地址 */ nos_uploader?: string; /** * IM NOS LBS 地址 */ im_nos_lbs?: string; /** * 下载地址的格式 */ nos_downloader_v2?: string; /** * 下载地址是否启用 https 协议 */ nosSsl?: boolean; /** * cdn 加速域名的匹配格式: 接到消息后附件里的链接若匹配到 nos_accelerate_host, 会按这个格式替换 */ nos_accelerate?: string; /** * cdn 加速域名的命中域名. 如果为空字符串代表放弃 cdn 加速域名逻辑 */ nos_accelerate_host?: string; /** * 数据上报域名 */ compassDataEndpoint?: string; /** * 是否开启数据上报。默认开启 */ enableCompass?: boolean; /** * 其他无用的配置项 */ [key: string]: any; }; export declare type NIMOtherOptionsAntispamUtilConfig = { /** * 是否打开本地反垃圾. 默认为 false * * 注: 需要在 IM 控制台配置本地反垃圾词库. 本开关打开后将会在登录完成后下载反垃圾词库. */ enable?: boolean; }; export declare type NIMOtherOptionsLoggerConfig = { /** * 日志等级. 默认 off 关闭日志打印. * * 注: 分别是关闭日志打印 | 打印 error 日志 | 打印 warn 级别及以上 | 打印 log 级别及以上 | 打印 debug 级别及以上 */ debugLevel?: 'off' | 'error' | 'warn' | 'log' | 'debug'; /** * 日志代理函数. * * 注: 拥有四个等级的日志输出方法. 所有日志经过这些方法代理. * * 注2: 代理函数的入参包含一个或者多个参数, 参数的类型为基础类型 */ logFunc?: { debug?: (...args: any) => void; log?: (...args: any) => void; warn?: (...args: any) => void; error?: (...args: any) => void; }; /** * 持久日志存储是否打开. 默认 true 打开 * * 注: 仅在浏览器与微信小程序环境里支持. 只会存储 log 级别及以上的日志 */ storageEnable?: boolean; /** * @deprecated 请替代使用 logDirPath 属性. */ storageName?: string; /** * 持久存储日志的标识名(数据库名/文件名). v10.9.60+ 支持. * * 注: 仅在浏览器与微信小程序环境里支持. 默认为 nim_logs */ logDirPath?: string; /** * 日志存储天数. v10.9.60+ 支持 * * 注: 仅在浏览器与微信小程序环境里支持. 单位天, 最小值 1, 默认值 10 天. */ logRetentionDays?: number; /** * 日志存储大小. v10.9.60+ 支持 * * 注: 仅在微信小程序环境里支持. 单位 MB, 最小值1, 默认值 200MB. */ totalLogSizeInMB?: number; /** * 单个文件存储大小. v10.9.60+ 支持 * * 注: 仅在微信小程序环境里支持. 单位 MB, 最小值 1, 默认值 10MB. */ maxLogFileSizeInMB?: number; }; export declare type NIMOtherOptionsAbtestConfig = { /** * @Multi_Lang_Tag * @locale cn * ABtest 是否开启，默认 true 开启 * * 注: 打开这个开关，在 sdk 内部会试探某些新功能的开启，建议开发者不要轻易设置它。 * @locale * * @locale en * Whether Abtest is enabled. The default value is true * * Note: If you turn on the switch, the SDK attempts to enable certain new features. You are recommended not turn on it. * @locale */ isAbtestEnable?: boolean; /** * abTest 服务器下发地址 */ abtestUrl?: string; /** * 对线上拉取到的 abtInfo 做预处理，返回值会作为实例最终生效的 abtInfo。 * * 可用于 ABTest 测试阶段覆盖或调整线上返回配置。 */ abtestInfoPreprocessor?: (abtInfo: NIMEStrAnyObj) => NIMEStrAnyObj; }; /** * 上报配置 */ export declare type NIMOtherOptionsReporterConfig = { /** * @Multi_Lang_Tag * @locale cn * 指南针是否开启，默认是 true * @locale * * @locale en * Whether compass is enabled. The default value is true * @locale */ enableCompass?: boolean; /** * @Multi_Lang_Tag * @locale cn * 指南针数据默认端点 * @locale * * @locale en * Default endpoint for compass data * @locale */ compassDataEndpoint?: string; /** * @Multi_Lang_Tag * @locale cn * @deprecated * 是否开启数据上报，默认是true * @locale * * @locale en * @deprecated * Whether data reporting is enabled. The default value is true * @locale */ isDataReportEnable?: boolean; }; export interface V2NIMChatroomEnterParams { /** * 是否启用聊天室 LBS 机制。默认 `false` * * 该参数由 Chatroom Web SDK v10 支持。 * * 关系说明： * 1. 这是 `enter` 维度的运行时开关，用来决定本次进入是否启用 SDK 内置聊天室 LBS * 2. 当 `enableLbs=true` 时，SDK 会读取初始化参数中的 `chatroomLbsList` 和 `chatroomLinkList` * 3. 当 `enableLbs=false` 时，SDK 不请求聊天室 LBS，`chatroomLbsList` 不生效 * * 与 `linkProvider` 的关系： * 1. 当 `enableLbs=true` 时，`linkProvider` 不是必填项；若存在，则作为 LBS 失败后的降级地址来源 * 2. 当 `enableLbs=false` 时，`linkProvider` 为必填项；SDK 不会读取初始化参数中的 `chatroomLinkList` */ enableLbs?: boolean; /** * 是否匿名。默认为 false * * 匿名模式不能发消息、只能收消息 */ anonymousMode?: boolean; /** * 账号ID * * 如果是匿名模式，可以不填，内部生成账号。 */ accountId?: string; /** * 静态 token。可以不填。不填时从 tokenProvider 获取 */ token?: string; /** * 进入聊天室的显示昵称 */ roomNick?: string; /** * 进入聊天室的头像 */ roomAvatar?: string; /** * 进入方法超时时间。默认为 60，单位为秒 * * 超过该时间如果没有进入成功，则返回失败 */ timeout?: number; /** * 聊天室登录相关信息 */ loginOption?: V2NIMChatroomLoginOption; /** * 获取聊天室 link 地址。 * * 当 `enableLbs=true` 时，`linkProvider` 为可选参数；仅在聊天室 LBS 失败时，SDK 才会降级使用 `linkProvider` 返回的地址。 * * 当 `enableLbs=false` 时，`linkProvider` 为非 LBS 模式下的唯一地址来源；若未提供，`enter` 会直接报错。 */ linkProvider?: (accountId: string, roomId: string) => Promise<Array<string>>; /** * 用户扩展字段 */ serverExtension?: string; /** * 通知扩展字段 */ notificationExtension?: string; /** * 聊天室进入的标签 */ tagConfig?: V2NIMChatroomTagConfig; /** * 聊天室进入的位置信息配置 */ locationConfig?: V2NIMChatroomLocationConfig; /** * 用户反垃圾检测 */ antispamConfig?: V2NIMAntispamConfig; } export interface V2NIMChatroomTagConfig { /** * 通知标签 */ notifyTargetTags: string; /** * 登录标签 */ tags: string[]; } export interface V2NIMChatroomLocationConfig { /** * 空间坐标信息 */ locationInfo?: V2NIMLocationInfo; /** * 订阅的消息的距离 */ distance: number; } export interface V2NIMLocationInfo { /** * 空间坐标X */ x?: number; /** * 空间坐标Y */ y?: number; /** * 空间坐标Z */ z?: number; } export interface V2NIMChatroomLoginOption { /** * 认证模式 */ authType?: V2NIMLoginAuthType; /** * token 提供回调 */ tokenProvider?: (appkey: string, roomId: string, accountId: string) => Promise<string>; /** * 在部分场景下，客户可能需要传输一些业务相关数据，则可采用该回调传输业务相关数据 */ loginExtensionProvider?: (appkey: string, roomId: string, accountId: string) => Promise<string>; /** * 抄送环境相关参数 */ routeConfig?: V2NIMRouteConfig; } export declare type V2NIMRouteConfig = { /** * 是否需要路由消息抄送。默认 true * * 注: 抄送需要打开控制台抄送配置 */ routeEnabled?: boolean; /** * 环境变量，用于指向不同的抄送 * * 注: 第三方回调等配置如果不填，则使用控制台默认抄送地址 */ routeEnvironment?: string; }; export interface V2NIMChatroomEnterInfo { /** * 进入聊天室的昵称 */ roomNick: string; /** * 进入聊天室的头像 */ roomAvatar: string; /** * 进入时间 */ enterTime: number; /** * 进入的终端类型 */ clientType: number; } /** * 标签临时禁言参数 */ export interface V2NIMChatroomTagTempChatBannedParams { /** * 禁言的 tag */ targetTag: string; /** * 消息的目标标签表达式，标签表达式 */ notifyTargetTags: string; /** * 禁言时长。单位秒。0表示取消 */ duration: number; /** * 是否需要通知 */ notificationEnabled: boolean; /** * 本次操作生成的通知中的扩展字段 */ notificationExtension: string; } export declare const enum DebugLevel { 'off' = "off", 'error' = "error", 'warn' = "warn", 'log' = "log", 'debug' = "debug" } export interface NIMEModuleParamCloudStorageConfig { /** * @Multi_Lang_Tag * @locale cn * NOS上传地址（直传） * 小程序、UniApp上传地址 * @locale * * @locale en * Address of NOS upload (direct transfer) * MiniApp, UniApp upload address * @locale */ commonUploadHost?: string; /** * @Multi_Lang_Tag * @locale cn * 小程序、UniApp上传地址备用域名 * @locale * * @locale en * MiniApp, UniApp upload backup address array * @locale */ commonUploadHostBackupList?: string[]; /** * @Multi_Lang_Tag * @locale cn * NOS上传地址（分片） * @locale * * @locale en * Address of NOS upload (chunked transfer) * @locale */ chunkUploadHost?: string; /** * @Multi_Lang_Tag * @locale cn * 发送文件消息中文件的url的通配符地址，例：'https://{host}/{object}' * @locale * * @locale en * Wildcard address of the file URL in the file message, for example: 'https://{host}/{object}'. * @locale */ uploadReplaceFormat?: string; /** * @Multi_Lang_Tag * @locale cn * 接收到文件消息的替换模版 * 这个是用来接到消息后，要按一定模式替换掉文件链接的。给予一个安全下载链接。 * 例：'https://{bucket}-nosdn.netease.im/{object}' * @locale * * @locale en * The template for the URL of the received file of a file message * If a file messages is received, the URL of a file is replaced with a specified patten for a secured download URL * Example: 'https://{bucket}-nosdn.netease.im/{object}' * @locale */ downloadUrl?: string; /** * @Multi_Lang_Tag * @locale cn * 收到哪些host地址，需要替换成downloadUrl，例：收到nos.netease.com/{bucket}/{obj} * @locale * * @locale en * received host addresses are replaced with downloadUrl, exmaple, nos.netease.com/{bucket}/{obj} * @locale */ downloadHostList?: string[]; /** * @Multi_Lang_Tag * @locale cn * 服务器下发的域名存在，并且对象前缀匹配成功，那么强行替换为`${protocol}${serverCdnDomain}/${decodePath.slice(prefixIndex)}` * @locale * * @locale en * If the CDN domain name exists and matches the prefix of an object, replace with `${protocol}${serverCdnDomain}/${decodePath.slice(prefixIndex)}` * @locale */ nosCdnEnable?: boolean; /** * @Multi_Lang_Tag * @locale cn * NOS 上传专用的 cdn 配置 * @locale * * @locale en * Dedicated CDN settings for NOS upload * @locale */ cdn?: { /** * @Multi_Lang_Tag * @locale cn * 默认的下载域名 * @locale * * @locale en * Default download domain name * @locale */ defaultCdnDomain?: string; /** * @Multi_Lang_Tag * @locale cn * 下载域名 * @locale * * @locale en * Download domain name * @locale */ cdnDomain?: string; /** * @Multi_Lang_Tag * @locale cn * 桶名, 一般 NOS 默认为 "nim" * @locale * * @locale en * Bucket name, in most case, "nim" is used * @locale */ bucket?: string; /** * @Multi_Lang_Tag * @locale cn * 路径前缀，一般不需要填写 * @locale * * @locale en * Prefix of an object, not required * @locale */ objectNamePrefix?: string; }; /** * @Multi_Lang_Tag * @locale cn * amazon aws s3 sdk * * 注：若传入 s3 sdk 后，本 SDK 根据融合存储策略配置，可能会 new 创建出它的实例并使用它的实例方法进行上传/存储。 * @locale * * @locale en * amazon aws s3 sdk * * Note: if S3 SDK is specified, an instance is created and used for upload and storage using the new operator based on the converged storage configuration. * @locale */ s3?: any; /** * @Multi_Lang_Tag * @locale cn * localStorage 缓存的云存储配置的键名的前缀。默认叫 NIMClient * * 注: 举个例子，根据默认配置，策略缓存的键叫 'NIMClient-AllGrayscaleConfig'。 * @locale * * @locale en * The prefix of a key of the cloud storage configuration of the localStorage cache. The default prefix is NIMClient. * * For example, by default, the key of the caching policy is called 'NIMClient-AllGrayscaleConfig'. * @locale */ storageKeyPrefix?: string; /** * @Multi_Lang_Tag * @locale cn * 是否开启 UniApp 分片上传。默认 false 关闭。 * * 注: 关闭时统一走旧表单上传；开启后优先分片上传，能力不足时再回退表单上传。UniApp H5 只有在显式开启时才会复用浏览器分片上传语义。 * @locale * * @locale en * Whether UniApp chunk upload is enabled. The default value is false. * * Note: If disabled, the SDK always uses the legacy form-upload path. If enabled, the SDK prefers chunk upload and falls back to form upload when chunk capability is unavailable. UniApp H5 only reuses browser chunk-upload semantics when this switch is explicitly enabled. * @locale */ enableUniappChunkUpload?: boolean; /** * @Multi_Lang_Tag * @locale cn * 是否需要开启融合存储整个策略。默认为 true * * 注: 为 false 则不会进行 lbs 灰度开关和策略获取，直接退化到老的 nos 上传逻辑。 * @locale * * @locale en * whether the converged storage is enabled. The default value is true * * Note: if false, does not get the option and policy of the lbs gray release and the old NOS upload logic is used. * @locale */ isNeedToGetUploadPolicyFromServer?: boolean; }