Options
All
  • Public
  • Public/Protected
  • All
Menu

Interface NIMBaseSendMsgOptions

Hierarchy

Index

Properties

Methods

Properties

Optional antiSpamBusinessId

antiSpamBusinessId?: string

安全通自定义业务 ID，传入此参数则消息通过安全通自定义业务进行安全审核；如需新增安全通自定义业务，请联系商务经理进行相关配置，然后前往云信控制台的安全通配置界面获取该业务 ID。

Optional antiSpamContent

antiSpamContent?: string

自定义消息中需额外进行审核的内容，yidunEnable 开启后才能配置该参数，且仅对自定义消息有效。必须传递 JSON 格式字符串，长度不超过 5,000 字节

格式如下：{"type": 1, "data": "custom content"}

字段说明：

  • type: 1-文本、2-图片、3-视频
  • data: 内容可以是文本内容、图片地址、视频地址

Optional antiSpamUsingYidun

antiSpamUsingYidun?: boolean

是否使用安全通对当前消息进行内容安全检测，默认 true

Optional apns

apns?: { accounts?: string[]; content?: string; forcePush?: boolean }

特殊推送选项, 只在群会话中使用

Type declaration

  • Optional accounts?: string[]

    需要特殊推送的 IM 账号（accid）列表, 不填表示推送给当前会话内的所有用户

  • Optional content?: string

    需要特殊推送的文案, 不填的话默认为 pushContent

  • Optional forcePush?: boolean

    是否强制推送, true 表示即使推送列表中的用户屏蔽了当前会话（如静音）, 仍能够推送当前这条内容给相应用户

Optional cc

cc?: boolean

是否将消息抄送至指定的第三方服务器（可以是应用服务器），默认 true

Optional clientAntiSpam

clientAntiSpam?: boolean

是否需要通过客户端反垃圾对该消息进行内容审核，默认 false

Optional custom

custom?: string

扩展字段

注：推荐使用 JSON 序列化字符串

Optional env

env?: string

指定当前消息需要抄送到或者回调到的环境的名称。开通消息抄送或第三方回调后，该环境名称可在云信控制台中配置（如下图），最大 32 个字符。

note

Optional isHistoryable

isHistoryable?: boolean

是否存储云端历史，默认 true

Optional isLocal

isLocal?: boolean

是否是本地消息，默认 false

注：此参数为 true，sdk 仅仅只是把消息存入库，不会发往 NIM 服务器

Optional isOfflinable

isOfflinable?: boolean

是否要存离线，默认 true

Optional isPushable

isPushable?: boolean

是否需要推送，默认 true

Optional isRoamingable

isRoamingable?: boolean

是否支持漫游，默认 true

Optional isSyncable

isSyncable?: boolean

是否支持发送方多端同步，默认 true

Optional isUnreadable

isUnreadable?: boolean

是否计入消息未读数，默认 true

Optional localFrom

localFrom?: string

本地消息的发送方，默认是当前用户.

isLocal 为 true 时生效。

Optional needMsgReceipt

needMsgReceipt?: boolean

是否需要业务已读，默认 false。该参数仅在群聊时生效，单聊时无需设置

注：msgReceipt 指的是本端发送的消息，对端是不是已读了本端的消息。

Optional needPushNick

needPushNick?: boolean

是否需要推送昵称，默认 true

Optional needUpdateSession

needUpdateSession?: boolean

是否需要刷新远端的服务器会话列表，默认是（请注意区分两种会话），默认为 true

Optional pushContent

pushContent?: string

自定义推送文案

Optional pushPayload

pushPayload?: string

自定义的推送属性。更多说明及相关示例请参见推送payload配置

注：必须使用 JSON 序列化字符串

Optional replyMsg

replyMsg?: NIMMessage

要回复的消息对象，表示当前消息是对某条消息的回复

Optional robotInfo

robotInfo?: { account?: string; customContent: string; function: string; topic: string }

AI自动对话机器人消息

Type declaration

  • Optional account?: string

    指定机器人账号，用户填写。(仅在群聊中有效，p2p会被忽略)

  • customContent: string

    指定自定义内容，用户填写

  • function: string

    指定机器人具体功能，用户填写

  • topic: string

    指定话题，用户填写

scene

scene: "p2p" | "team" | "superTeam"

消息场景

Optional subType

subType?: number

消息子类型。格式为大于0的整数，开发者需要自行映射其含义

to

to: string

接收方信息

  • 单聊场景下为消息接收方的 IM 帐号(accid)
  • 群聊或超大群场景下为群 ID

Optional yidunAntiCheating

yidunAntiCheating?: string

易盾反作弊字段，长度限制1024，JSON 序列化字符串。

如："{"email":"test@163.com","phone":"12345678901","token":"1234","extension":"hello"}"

Optional yidunAntiSpamExt

yidunAntiSpamExt?: string

易盾反作弊扩展字段字段，2021-08-09 追加。JSON 序列化字符串，长度上限 1024

Optional yidunEnable

yidunEnable?: boolean

是否需要对自定义消息的指定内容（antiSpamContent）进行安全检测，默认 false

Methods

Optional beforesend

  • 消息构建完成，在发送前触发的回调

    注：此时 idClient 已经构建完毕，status 为 sending，time 为端测本地时间。

    Parameters

    Returns void

Optional done

  • 消息发送成功回调

    注：接到 NIM 服务器回包后，传回 idServer，更正 status 为 success，time 更正为服务器侧的发送时间。

    Parameters

    Returns void