sendMessageNotOss

功能介绍

说明

发送消息。

注意

需要先调用createXXXMessage创建一条消息，createXXXMessageByURL创建的消息必须通过此接口发送。
相关回调：
onConversationChanged onRecvNewMessage
onRecvNewMessages

iOS

函数原型

  Future<Message> sendMessageNotOss({
    required Message message,
    required OfflinePushInfo offlinePushInfo,
    String? userID,
    String? groupID,
    String? operationID,
  })

输入参数

参数名称	参数类型	是否必填	描述
message	Message	是	消息体
userID	String	否	接收消息的 user ID
groupID	String	否	接收消息的 group ID
offlinePushInfo	OfflinePushInfo	否	离线消息体

返回结果

名称	类型	描述
~	Message	成功返回

代码示例

   Message msg =  await OpenIM.iMManager.messageManager.sendMessageNotOss(message: message, offlinePushInfo: offlinePushInfo);
    // todo

Android

函数原型

- (void)sendMessageNotOss:(OIMMessageInfo *)message
                   recvID:(NSString * _Nullable)recvID
                  groupID:(NSString * _Nullable)groupID
          offlinePushInfo:(OIMOfflinePushInfo * _Nullable)offlinePushInfo
                onSuccess:(nullable OIMMessageInfoCallback)onSuccess
               onProgress:(nullable OIMNumberCallback)onProgress
                onFailure:(nullable OIMFailureCallback)onFailure;

输入参数

参数名称	参数类型	是否必填	描述
message	OIMMessageInfo	是	消息体
recvID	NSSting	否	接收消息的 user ID
groupID	NSSting	否	接收消息的 group ID
offlinePushInfo	OIMOfflinePushInfo	否	离线消息体

返回结果

名称	类型	描述
onSuccess	OIMMessageInfo	成功返回
onProgress	NSInteger	发送进度
onFailure	OIMFailureCallback	失败返回

代码示例

OIMMessageInfo *testMessage = [OIMMessageInfo createSoundMessageByURL:@"https://xxx"
                                                             duration:1
                                                                 size:1];

[OIMManager.manager sendMessageNotOss:testMessage
                               recvID:@""
                              groupID:@""
                      offlinePushInfo:nil
                            onSuccess:^(OIMMessageInfo * _Nullable message) {
} onProgress:^(NSInteger number) {
} onFailure:^(NSInteger code, NSString * _Nullable msg) {
}];

Flutter

函数原型

    public void sendMessageNotOss(OnMsgSendCallback base, Message message, String recvUid, String recvGid, OfflinePushInfo offlinePushInfo)

输入参数

参数名称	参数类型	是否必填	描述
base	OnMsgSendCallback	是	callback
message	Message	是	消息体
userID	String	否	接收消息的 user ID
groupID	String	否	接收消息的 group ID
offlinePushInfo	OfflinePushInfo	否	离线消息体

返回结果

名称	类型	描述
~	Message	成功返回

代码示例

      OpenIMClient.getInstance().messageManager.sendMessageNotOss( new OnMsgSendCallback(){

              @Override
              public void onError(int code, String error) {
                  //发送失败
              }

              @Override
              public void onProgress(long progress) {
                    //发送进度
              }

              @Override
              public void onSuccess(Message s) {
                     //发送成功
              }
          },  message,  recvUid,  recvGid,  offlinePushInfo);

uni-app

函数原型

IMSDK.sendMessageNotOss({
  recvID: string;
  groupID: string;
  offlinePushInfo?: OfflinePush;
  message: MessageItem;
}, operationID?: string): Promise<WsResponse<MessageItem>>

输入参数

参数名称	参数类型	是否必填	描述
message	MessageItem	是	消息体
recvID	string	是	接收消息的 user ID，发送群消息时传空字符串
groupID	string	是	接收消息的 group ID，发送单聊消息时传空字符串
offlinePushInfo	OfflinePushInfo	否	离线消息体

返回结果

参数名称	参数类型	描述
Promise.then()	Promise<WsResponse<MessageItem>>	调用成功回调
Promise.catch()	Promise<WsResponse>	调用失败回调

代码示例

import { getSDK } from '@openim/wasm-client-sdk';
const IMSDK = getSDK();

// use in electron with ffi
// import { getWithRenderProcess } from '@openim/electron-client-sdk/lib/render';
// const { instance: IMSDK } = getWithRenderProcess();

// use in mini program
// import { getSDK } from '@openim/client-sdk';
// const IMSDK = getSDK();

IMSDK.sendMessageNotOss({
  recvID: "userID",
  groupID: "",
  message: {
    // MessageItem
    ...
  }
})
  .then(({ data }) => {
    // 调用成功
  })
  .catch(({ errCode, errMsg }) => {
    // 调用失败
  });

Browser/Electron/MiniProgram

函数原型

IMSDK.asyncApi('sendMessageNotOss', operationID: string, {
    recvID: string;
    groupID: string;
    offlinePushInfo?: OfflinePush;
    message: MessageItem;
}): Promise<void>

输入参数

参数名称	参数类型	是否必填	描述
operationID	string	是	操作 ID，用于定位问题，保持唯一，建议用当前时间和随机数
message	MessageItem	是	消息体
recvID	string	是	接收消息的 user ID，发送群消息时传空字符串
groupID	string	是	接收消息的 group ID，发送单聊消息时传空字符串
offlinePushInfo	OfflinePushInfo	是	离线消息体

返回结果

通过openim-uniapp-polyfill包将函数 Promise 化，调用时需要使用then和catch判断并处理成功和失败回调。

参数名称	参数类型	描述
Promise.then()	Promise<void>	调用成功回调
Promise.catch()	Promise<CatchResponse>	调用失败回调

代码示例

import IMSDK from 'openim-uniapp-polyfill';

IMSDK.asyncApi('sendMessageNotOss', IMSDK.uuid(), {
  recvID: "userID",
  groupID: "",
  message: {
    // MessageItem
    ...
  },
  offlinePushInfo: {
    title: 'you have a new message',
    desc: 'new message',
    ex: '',
    iOSPushSound: '+1',
    iOSBadgeCount: true,
  }
})
  .then((data) => {
    // 调用成功
  })
  .catch(({ errCode, errMsg }) => {
    // 调用失败
  });

React-Native

函数原型

OpenIMSDK.sendMessageNotOss({
  recvID: string;
  groupID: string;
  offlinePushInfo?: OfflinePush;
  message: MessageItem;
}, operationID?: string): Promise<void>

输入参数

参数名称	参数类型	是否必填	描述
message	MessageItem	是	消息体
recvID	string	是	接收消息的 user ID，发送群消息时传空字符串
groupID	string	是	接收消息的 group ID，发送单聊消息时传空字符串
offlinePushInfo	OfflinePushInfo	是	离线消息体
operationID	string	否	操作 ID，用于定位问题，保持唯一，建议用当前时间和随机数

返回结果

参数名称	参数类型	描述
Promise.then()	Promise<void>	调用成功回调
Promise.catch()	Promise<OpenIMApiError>	调用失败回调

代码示例

import OpenIMSDK from "@openim/rn-client-sdk";

OpenIMSDK.sendMessageNotOss({
  recvID: "userID",
  groupID: "",
  message: {
    // MessageItem
    ...
  },
  offlinePushInfo: {
    title: 'you have a new message',
    desc: 'new message',
    ex: '',
    iOSPushSound: '+1',
    iOSBadgeCount: true,
  }
})
  .then((data) => {
    // 调用成功
  })
  .catch((error) => {
    // 调用失败
  });

Unity

函数原型

public static void SendMessageNotOSS(IMsgSendCallBack cb, Message message, string recvId, string groupId, OfflinePushInfo offlinePushInfo, bool isOnlineOnly)

输入参数

参数名称	参数类型	是否必填	描述
cb	IMsgSendCallBack	是	回调
message	Message	是	消息体
userId	string	否	接收消息的 user ID
groupId	string	否	接收消息的 group ID
offlinePushInfo	OfflinePushInfo	否	离线消息体
isOnlineOnly	bool	是	接收者在线才能收到，否则将会丢失

返回结果

名称	类型	描述
~	Message	成功返回

代码示例

var callback = new MsgSendCallBack(); // 实现IMsgSendCallBack接口
IMSDK.SendMessageNotOSS(callback,msg ,recvId,groupId,new OfflinePushInfo(){},false);