sendMediaMessage static method
- MediaMessage mediaMessage, {
- MessageSentListener? listener,
- dynamic onSuccess(
- MediaMessage message
- dynamic onError(
- CometChatException excep
send a media message like photos, videos & files.
filePath The file path object to be sent, need to prefix the path with 'file://' for IOS.
messageType type of the message that needs to be sent image,video,audio,file
receiver Group or User class from which UID and GUID will be fetched according to need.
receiverType ype of the receiver to whom the message is to be sent user,group.
On success, you will receive an object of the MediaMessage class containing all the information related to the sent media message.
Migration Note: Migrated from platform channels to native Dart implementation. Behavior and signature remain identical for backward compatibility.
Android Reference: MessagesRequest.sendMediaMessage(MediaMessage message)
The method could throw PlatformException with error codes specifying the cause
Offline (opt-in, additive): pass listener for the three-phase send.
A listener-less send never enters the outbox — see _offlineAdoptingSend.
Implementation
static Future<MediaMessage?> sendMediaMessage(
MediaMessage mediaMessage, {
MessageSentListener? listener,
Function(MediaMessage message)? onSuccess,
Function(CometChatException excep)? onError,
}) async {
final offlineAcked = await _offlineAdoptingSend(mediaMessage, listener);
if (offlineAcked != null) return offlineAcked as MediaMessage?;
try {
// Get SDK instance
final sdk = SdkRegistry.getInstance();
// Call native Dart message repository
final sentMessage = await sdk.messages.sendMediaMessage(mediaMessage);
// A7: an own threaded send auto-subscribes the sender (BEH-FLAG-08).
// Queued, not awaited: the callback never waits on the cache.
unawaited(OfflineRuntime.instance.onOwnDirectSendSucceeded(sentMessage));
// Call success callback (listener wins — never both).
if (listener != null) {
listener.onMessageSent(sentMessage);
} else if (onSuccess != null) {
onSuccess(sentMessage);
}
return sentMessage;
} on SdkException catch (sdkEx) {
// Convert SdkException to CometChatException
final cometChatEx = CometChatException(
sdkEx.code,
sdkEx.details ?? sdkEx.message,
sdkEx.message,
);
if (listener != null) {
listener.onError(cometChatEx);
} else {
_errorCallbackHandler(cometChatEx, null, null, onError);
}
} catch (e) {
if (listener != null) {
listener.onError(
CometChatException('ERROR', e.toString(), e.toString()),
);
} else {
_errorCallbackHandler(null, null, e, onError);
}
}
return null;
}