设置推送扩展

大约 5 分钟

设置推送扩展

你可以利用扩展字段实现自定义推送设置，本文以强制推送、发送静默消息和富文本推送为例介绍如何实现推送扩展功能。

对于推送扩展字段，详见离线推送扩展字段文档。

自定义推送字段

EMTextMessageBody *body = [[EMTextMessageBody alloc] initWithText:@"test"];
EMChatMessage *message = [[EMChatMessage alloc] initWithConversationID:conversationId from:currentUsername to:conversationId body:body ext:nil];
message.ext = @{@"em_apns_ext":@{@"extern":@"custom string"}}; 
message.chatType = EMChatTypeChat; 
[EMClient.sharedClient.chatManager sendMessage:message progress:nil completion:nil];
参数描述
body消息体。
ConversationID消息属于的会话 ID。
from消息发送方，一般为当前登录 ID。
to消息接收方 ID，一般与 ConversationID 一致。
em_apns_ext消息扩展，使用扩展的方式向推送中添加自定义字段，该值为固定值，不可修改。
extern自定义字段 key，用于设置自定义的内容，该值为固定值，不可修改。
custom string自定义字段内容。

解析的内容

{
    "apns": {
        "alert": {
            "body": "test"
        }, 
        "badge": 1, 
        "sound": "default"
    }, 
    "e": "custom string", 
    "f": "6001", 
    "t": "6006", 
    "m": "373360335316321408"
}
参数描述
body显示内容。
badge角标数。
sound提示铃声。
f消息发送方 ID。
t消息接收方 ID。
e自定义信息。
m消息 ID。

自定义铃声

推送铃声是指用户收到推送时的提示音，你需要将音频文件加入到 app 中，并在推送中配置使用的音频文件名称。

  • 支持格式 Linear PCM MA4 (IMA/ADPCM) µLaw aLaw。
  • 音频文件存放路径 AppData/Library/Sounds，时长不得超过 30 秒。

更多内容可以参考苹果官方文档：生成远程推送通知open in new window。

EMTextMessageBody *body = [[EMTextMessageBody alloc] initWithText:@"test"];
EMChatMessage *message = [[EMChatMessage alloc] initWithConversationID:conversationId from:currentUsername to:conversationId body:body ext:nil];
message.ext = @{@"em_apns_ext":@{@"em_push_sound":@"custom.caf"}};
message.chatType = EMChatTypeChat; 
[EMClient.sharedClient.chatManager sendMessage:message progress:nil completion:nil];
参数描述
body消息体。
ConversationID消息属于的会话 ID。
from消息发送方，一般为当前登录 ID。
to消息接收方 ID，一般与 ConversationID 一致。
em_apns_ext消息扩展，使用扩展的方式向推送中添加自定义字段，该值为固定值，不可修改。
em_push_sound自定义字段，用于设置自定义要显示的内容，该值为固定值，不可修改。
custom.caf音频文件名称。

解析的内容

{
    "aps":{
        "alert":{
            "body":"你有一条新消息"
        },  
        "badge":1,  
        "sound":"custom.caf"  
    },
    "f":"6001",  
    "t":"6006",  
    "m":"373360335316321408"  
}
参数描述
body显示内容。
badge角标数。
sound提示铃声。
f消息发送方 ID。
t消息接收方 ID。
m消息 ID。

强制推送

使用该方式设置后，本条消息会忽略接收方的免打扰设置，不论是否处于免打扰时间段都会正常向对方推送通知；

EMTextMessageBody *body = [[EMTextMessageBody alloc] initWithText:@"test"];
EMChatMessage *message = [[EMChatMessage alloc] initWithConversationID:conversationId from:currentUsername to:conversationId body:body ext:nil];
message.ext = @{@"em_force_notification":@YES};
[EMClient.sharedClient.chatManager sendMessage:message progress:nil completion:nil];
参数描述
body消息体。
ConversationID消息属于的会话 ID。
from消息发送方，一般为当前登录 ID。
to消息接收方 ID，一般与 ConversationID 一致。
em_force_notification是否为强制推送：
- YES：强制推送
- （默认）NO：非强制推送。
该字段名固定，不可修改。

发送静默消息

发送静默消息指发送方在发送消息时设置不推送消息，即用户离线时，环信即时通讯 IM 服务不会通过第三方厂商的消息推送服务向该用户的设备推送消息通知。因此，用户不会收到消息推送通知。当用户再次上线时，会收到离线期间的所有消息。

发送静默消息和免打扰模式下均为不推送消息，区别在于发送静默消息为发送方在发送消息时设置，而免打扰模式为接收方设置在指定时间段内不接收推送通知。

EMTextMessageBody *body = [[EMTextMessageBody alloc] initWithText:@"test"];
EMChatMessage *message = [[EMChatMessage alloc] initWithConversationID:conversationId from:currentUsername to:conversationId body:body ext:nil];
message.ext = @{@"em_ignore_notification":@YES};
[EMClient.sharedClient.chatManager sendMessage:message progress:nil completion:nil];
参数描述
body消息体。
ConversationID消息属于的会话 ID。
from消息发送方，一般为当前登录 ID。
to消息接收方 ID，一般与 ConversationID 一致。
em_ignore_notification是否发送静默消息。
- YES：发送静默消息；
- （默认）NO：推送该消息。
该字段名固定，不可修改。

实现富文本推送

如果你的目标平台是 iOS 10.0 或以上版本，你可以参考如下代码实现 UNNotificationServiceExtensionopen in new window 的富文本推送功能。

EMTextMessageBody *body = [[EMTextMessageBody alloc] initWithText:@"test"];
EMChatMessage *message = [[EMChatMessage alloc] initWithConversationID:conversationId from:currentUsername to:conversationId body:body ext:nil];
message.ext = @{@"em_apns_ext":@{@"em_push_mutable_content":@YES}}; 
message.chatType = EMChatTypeChat; 
[EMClient.sharedClient.chatManager sendMessage:message progress:nil completion:nil];
参数描述
body消息体。
ConversationID消息属于的会话 ID。
from消息发送方，一般为当前登录 ID。
to消息接收方 ID，一般与 ConversationID 一致。
em_apns_ext消息扩展字段，该字段名固定，不可修改。该字段用于配置富文本推送通知，包含自定义字段。
em_push_mutable_content是否使用富文本推送通知（em_apns_ext）：
- YES：富文本推送通知；
- （默认）NO：普通推送通知。
该字段名固定，不可修改。

接收方收到富文本推送时，会进入回调 didReceiveNotificationRequest:withContentHandler:，示例代码如下：

- (void)didReceiveNotificationRequest:(UNNotificationRequest *)request withContentHandler:(void (^)(UNNotificationContent * _Nonnull))contentHandler {
    // 推送扩展字段
    NSDictionary *userInfo = request.content.userInfo;
    // 通知内容
    UNNotificationContent *content = [request.content mutableCopy];
    contentHandler(content);
}

解析的内容

{
    "aps":{
        "alert":{
            "body":"test"
        },  
        "badge":1,  
        "sound":"default",
        "mutable-content":1  
    },
    "f":"6001",  
    "t":"6006",  
    "m":"373360335316321408"  
}
参数描述
body显示内容。
badge角标数。
sound提示铃声。
mutable-content苹果要求的关键字，存在之后才可唤醒 UNNotificationServiceExtension。
f消息发送方 ID。
t消息接收方 ID。
m消息 ID。
环信 IM 文档 Version: 1.0.0 ©️环信