环信3.0ios客户端的集成(十二)

版本记录

版本号 时间
V1.0 2017.06.10

前言

很多app种都集成环信做第三方信息通讯工具,这里我们就看一下环信的主要功能和集成方法。先给出环信3.0的地址。
感兴趣的可以参考:
1. 环信ios客户端的集成(一)
2. 环信ios客户端的集成(二)
3. 环信ios客户端的集成(三)
4. 环信ios客户端的集成(四)
5. 环信ios客户端的集成(五)
6. 环信ios客户端的集成(六)
7. 环信ios客户端的集成(七)
8. 环信ios客户端的集成(八)
9. 环信ios客户端的集成(九)
10. 环信ios客户端的集成(十)
11. 环信ios客户端的集成(十一)
这一篇主要说一下环信的 APNS 内容解析

一、单聊

1.不显示详情

{
    "aps":{
        "alert":"您有一条新消息",   
        "badge":1,               
        "sound":"default"        
    },
    "f":"6001",                  
    "t":"6006",                  
    "m":"14aec1e00ef"            
}

  • alert: 显示信息
  • badge: 角标,表示离线消息数
  • sound: 收到 APNS 时的提示音
  • f: 消息发送方的环信 ID
  • t: 消息接收方的环信 ID
  • m: 消息 ID

2.显示详情

{
    "aps":{
        "alert":"ApnsName:xxxx",     
        "badge":1,               
        "sound":"default"        
    },
    "f":"6001",                  
    "t":"6006",                  
    "m":"14aec1e00ef"            
}
  • alert: 显示信息
  • ApnsName: 发送方设置的用户名(即环信管理后台中看到的用户昵称)
  • xxxx: 消息内容(发送方发的什么,就显示什么)
  • badge: 角标,表示离线消息数
  • sound: 收到 APNS 时的提示音
  • f: 消息发送方的环信 ID
  • t: 消息接收方的环信 ID
  • m: 消息 ID

二、群聊

1.不显示详情

{
    "aps":{
        "alert":"您有一条新消息",   
        "badge":1,               
        "sound":"default"        
    },
    "f":"6001",                  
    "t":"6006", 
    "g":"1421300621769",                 
    "m":"14aec1e00ef"            
}
  • alert: 显示信息
  • badge: 角标,表示离线消息数
  • sound: 收到 APNS 时的提示音
  • f: 消息发送方的环信 ID
  • t: 消息接收方的环信 ID
  • g: 群组 ID
  • m: 消息 ID

2.显示详情

{
    "aps":{
        "alert":"ApnsName:xxxx",     
        "badge":1,               
        "sound":"default"        
    },
    "f":"6001",                  
    "t":"6006",     
    "g":"1421300621769",
    "m":"14aec1e00ef"            
}
  • alert: 显示信息
  • ApnsName: 发送方设置的用户名(即环信管理后台中看到的用户昵称)
  • xxxx: 消息内容(发送方发的什么,就显示什么)
  • badge: 角标,表示离线消息数
  • sound: 收到 APNS 时的提示音
  • f: 消息发送方的环信 ID
  • t: 消息接收方的环信 ID
  • g: 群组 ID
  • m: 消息 ID

三、向 APNS 中添加扩展字段(em_apns_ext)

APNS扩展:添加后,您收到的 APNS 中将带有您填写的字段,可以帮助您区分 APNS。

1.解析内容

{
    "aps":{
        "alert":"您有一条新消息",   
        "badge":1,               
        "sound":"default"        
    },
    "f":"6001",                  
    "t":"6006",                  
    "e":"扩展内容",
    "m":"14aec1e00ef"            
}
  • e: 您发送的自定义内容

2.发送扩展

REST 发送

(REST 发消息)

{
    "target_type":"users",
    "target":[
        "6006"
    ],
    "msg":{
        "type":"txt",
        "msg":"hello from rest"
    },
    "from":"6001",
    "ext":{
        "em_apns_ext":"扩展内容"
    }
}

iOS 发送

(iOS 发消息)

EMChatText *txt = [[EMChatText alloc] initWithText:@"test"];
EMTextMessageBody *body = [[EMTextMessageBody alloc] initWithChatObject:txt];
EMMessage *msg = [[EMMessage alloc] initWithReceiver:@"6001" bodies:@[body]];
// 设置自定义扩展字段
msg.ext = @{@"em_apns_ext":@"扩展内容"};
// 发送消息
[[EaseMob sharedInstance].chatManager asyncSendMessage:msg progress:nil]; 


四、 发送静默消息(不发APNS,em_ignore_notification)

发送时添加后,该消息将不会有 APNS 推送。

REST 发送
(REST 发消息)


{
    "target_type":"users",
    "target":[
        "6006"
    ],
    "msg":{
        "type":"txt",
        "msg":"hello from rest"
    },
    "from":"6001",
    "ext":{
        "em_ignore_notification":true
    }
}

iOS 发送
(iOS 发消息)

EMChatText *txt = [[EMChatText alloc] initWithText:@"test"];
EMTextMessageBody *body = [[EMTextMessageBody alloc] initWithChatObject:txt];
EMMessage *msg = [[EMMessage alloc] initWithReceiver:@"6001" bodies:@[body]];
// 设置自定义扩展字段
msg.ext = @{@"em_ignore_notification":@YES};
// 发送消息
[[EaseMob sharedInstance].chatManager asyncSendMessage:msg progress:nil];


五、 设置强制推送型 APNS(em_force_notification)

设置后,将强制推送消息,即使客户端设置了免打扰时间,也会得到推送。优先级比 em_ignore_notification 低,即同时设置 em_ignore_notification 后,该属性将失效。

REST 发送
(REST 发消息)

{
    "target_type":"users",
    "target":[
        "6006"
    ],
    "msg":{
        "type":"txt",
        "msg":"hello from rest"
    },
    "from":"6001",
    "ext":{
        "em_force_notification":true
    }
}

iOS 发送
(iOS 发消息)

EMChatText *txt = [[EMChatText alloc] initWithText:@"test"];
EMTextMessageBody *body = [[EMTextMessageBody alloc] initWithChatObject:txt];
EMMessage *msg = [[EMMessage alloc] initWithReceiver:@"6001" bodies:@[body]];
// 设置自定义扩展字段
msg.ext = @{@"em_force_notification":@YES};
// 发送消息
[[EaseMob sharedInstance].chatManager asyncSendMessage:msg progress:nil];


六、 自定义显示

设置后,您收到的 APNS 的 alert 信息将是您设置的信息。

解析

{
    "aps":{
        "alert":"自定义信息",     
        "badge":1,               
        "sound":"default"        
    },
    "f":"6001",                  
    "t":"6006",                  
    "m":"14aec1e00ef"            
}

REST 发送
(REST 发消息)

{
    "target_type":"users",
    "target":[
        "6006"
    ],
    "msg":{
        "type":"txt",
        "msg":"hello from rest"
    },
    "from":"6001",
    "ext":{
        "em_apns_ext":{
            "em_push_title":"自定义信息"
        }
    }
}

iOS 发送
(iOS 发消息)

EMChatText *txt = [[EMChatText alloc] initWithText:@"test"];
EMTextMessageBody *body = [[EMTextMessageBody alloc] initWithChatObject:txt];
EMMessage *msg = [[EMMessage alloc] initWithReceiver:@"6001" bodies:@[body]];
// 设置自定义扩展字段
msg.ext = @{@"em_apns_ext":@{@"em_push_title":@"自定义信息"}};
// 发送消息
[[EaseMob sharedInstance].chatManager asyncSendMessage:msg progress:nil];

七、自定义显示与自定义扩展同时发给对方

解析

{
    "aps":{
        "alert":"自定义信息",     
        "badge":1,               
        "sound":"default"        
    },
    "f":"6001",                  
    "t":"6006",                  
    "m":"14aec1e00ef",
    "e":"扩展内容"
}

REST 发送
(REST 发消息)


{
    "target_type":"users",
    "target":[
        "6006"
    ],
    "msg":{
        "type":"txt",
        "msg":"hello from rest"
    },
    "from":"6001",
    "ext":{
        "em_apns_ext":{
            "em_push_title":"自定义信息",
                        "extern": "扩展内容"
        }
    }
}

iOS 发送
(iOS 发消息)

EMChatText *txt = [[EMChatText alloc] initWithText:@"test"];
EMTextMessageBody *body = [[EMTextMessageBody alloc] initWithChatObject:txt];
EMMessage *msg = [[EMMessage alloc] initWithReceiver:@"6001" bodies:@[body]];
// 设置自定义扩展字段
msg.ext = @{@"em_apns_ext":@{@"em_push_title":@"自定义信息",@"extern":@"扩展内容"}};
// 发送消息
[[EaseMob sharedInstance].chatManager asyncSendMessage:msg progress:nil];

后记

未完,待续~~~

美得不像话

推荐阅读更多精彩内容

  • 1)项目里面不需要环信SDK的太多功能,只是想要聊天和好友功能,其他都不用,那SDK一定要总是跟着更新么? a.环...
    DefaultYuan阅读 22,946评论 19 59
  • 版本记录 前言 很多app种都集成环信做第三方信息通讯工具,这里我们就看一下环信的主要功能和集成方法。先给出环信3...
    刀客传奇阅读 166评论 0 0
  • 版本记录 前言 很多app种都集成环信做第三方信息通讯工具,这里我们就看一下环信的主要功能和集成方法。先给出环信3...
    刀客传奇阅读 325评论 3 2
  • 点击查看原文 Web SDK 开发手册 SDK 概述 网易云信 SDK 为 Web 应用提供一个完善的 IM 系统...
    layjoy阅读 6,895评论 0 14
  • 最近一段时间工作量比较大, 抽不出时间来整理博客, 趁今天任务量较小的时候整理下关于环信推送的问题, 介绍. 集成...
    IMGeek阅读 935评论 1 3