setConversationDraft

Description

info

Set a conversation draft.

Note

Setting it to empty will clear the draft.

Related Callbacks:
onConversationChanged

iOS

Function Prototype

  Future setConversationDraft({
    required String conversationID,
    required String draftText,
    String? operationID,
  })

Input Parameters

Parameter Name	Parameter Type	Required	Description
conversationID	String	Yes	Conversation ID
draftText	String	Yes	Draft content

Return Result

Name	Type	Description
~	~	Operation successful if no exception thrown

Code Example

    await OpenIM.iMManager.conversationManager.setConversationDraft(conversationID: conversationID, draftText: draftText);
    //todo

Android

Function Prototype

- (void)setConversationDraft:(NSString *)conversationID
                   draftText:(NSString *)draftText
                   onSuccess:(nullable OIMSuccessCallback)onSuccess
                   onFailure:(nullable OIMFailureCallback)onFailure;

Input Parameters

Parameter Name	Parameter Type	Required	Description
conversationID	NSString	Yes	Conversation ID
draftText	NSString	Yes	Draft content

Return Result

Name	Type	Description
onSuccess	OIMSuccessCallback	Success return
onFailure	OIMFailureCallback	Failure return

Code Example

[OIMManager.manager setConversationDraft:@""
                               draftText:@""
                               onSuccess:^(NSString * _Nullable data) {

} onFailure:^(NSInteger code, NSString * _Nullable msg) {

}];

Flutter

Function Prototype

 public void setConversationDraft(OnBase<String> base, String conversationID, String draftText)

Input Parameters

Parameter Name	Parameter Type	Required	Description
base	OnBase<String>	Yes	Callback interface
conversationID	String	Yes	Conversation ID
draftText	String	Yes	Draft content

Code Example

           OpenIMClient.getInstance().conversationManager.setConversationDraft(new OnBase<String>() {
               @Override
               public void onError(int code, String error) {

               }

               @Override
               public void onSuccess(String data) {

               }
           },conversationID,draftText);

uni-app

Function Prototype

IMSDK.setConversationDraft({
    conversationID: string;
    draftText: string;
},operationID?: string): Promise<WsResponse>

Input Parameters

Parameter Name	Parameter Type	Required	Description
conversationID	string	Yes	Conversation ID
draftText	string	Yes	Draft content

Return Result

Parameter Name	Parameter Type	Description
Promise.then()	Promise<WsResponse>	Success callback
Promise.catch()	Promise<WsResponse>	Failure callback

Code Example

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();

IMSDK.setConversationDraft({
  conversationID: 'conversationID',
  draftText: 'draft',
})
  .then(({ data }) => {
    // Call successful
  })
  .catch(({ errCode, errMsg }) => {
    // Call failed
  });

Browser/Electron

Function Prototype

IMSDK.asyncApi('setConversationDraft', operationID: string, {
  conversationID: string;
  draftText: string;
}): Promise<void>

Input Parameters

Parameter Name	Parameter Type	Required	Description
operationID	string	Yes	Operation ID, used to pinpoint issues, keep unique, prefer time+random
conversationID	string	Yes	Conversation ID
draftText	string	Yes	Draft content

Return Result

Use the openim-uniapp-polyfill package to make the function Promise. When calling, you need to use then and catch to determine and handle success and failure callbacks.

Parameter Name	Parameter Type	Description
Promise.then()	Promise<void>	Success callback
Promise.catch()	Promise<CatchResponse>	Failure callback

Code Example

import IMSDK from 'openim-uniapp-polyfill';

IMSDK.asyncApi('setConversationDraft', IMSDK.uuid(), {
  conversationID: '',
  draftText: '',
})
  .then(() => {
    // Call successful
  })
  .catch(({ errCode, errMsg }) => {
    // Call failed
  });

React-Native

Function Prototype

OpenIMSDK.setConversationDraft({
  conversationID: string,
  draftText: string,
}, operationID?: string): Promise<void>

Input Parameters

Parameter Name	Parameter Type	Required	Description
conversationID	string	Yes	Conversation ID
draftText	string	Yes	Draft content
operationID	string	No	Operation ID, used to pinpoint issues, keep unique, prefer time+random

Return Result

Parameter Name	Parameter Type	Description
Promise.then()	Promise<void>	Success callback
Promise.catch()	Promise<OpenIMApiError>	Failure callback

Code Example

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

OpenIMSDK.setConversationDraft({
  conversationID: '',
  draftText: '',
})
  .then(() => {
    // Call successful
  })
  .catch((error) => {
    // Call failed
  });

Unity

Function Prototype

public static void SetConversationDraft(OnBase<bool> cb, string conversationId, string draftText)

Input Parameters

Parameter Name	Parameter Type	Required	Description
cb	OnBase	Yes	Callback function
conversationId	string	Yes	Conversation ID
draftText	string	Yes	Draft content

Code Example

IMSDK.SetConversationDraft((suc,errCode,errMsg)=>{

},conversationId,draftText);