版本记录
| 版本号 | 时间 |
|---|---|
| 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客户端的集成（九）
这一篇主要说一下环信的 环信红包接入文档(iOS)。
新开商户可免费发送累计5000元总额的红包，超过5000元后，红包功能自动关闭，直到商户付费购买增值服务“红包功能”后，该功能重新开启，购买增值服务请咨询环信商务经理。
一、集成概述
- 红包SDK分为两个版本，即钱包版红包SDK与支付宝版红包SDK。
- 使用钱包版红包SDK的用户，可以使用银行卡支付或支付宝支付等第三方支付来发红包；收到的红包金额会进入到钱包余额，并支持提现到绑定的银行卡。
- 使用支付宝版红包SDK的用户，发红包仅支持支付宝支付；收到的红包金额即时入账至绑定的支付宝账号。
- 请选择希望接入的版本并下载对应的SDK进行集成，钱包版红包SDK与支付宝版红包SDK集成方式相同。
- 需要注意的是如果已经集成了钱包版红包SDK，暂不支持切换到支付宝版红包SDK（两个版本不支持互通）。
- 集成演示Demo，开发者可以通过此Demo了解iOS红包SDK的集成，集成方式仅供参考。
二、红包开源模块
红包开源模块介绍
RedpacketAliPay
- 为支付宝版SDK处理支付宝授权和支付宝支付回调
RedpacketJDPay
- 为钱包版SDK处理支付宝支付回调
RedpacketCell
- 红包SDK内的红包卡片样式
RedpacketCellResource.bundle
- 红包开源部分的资源文件
RedpacketChatViewController
- 继承自ChatViewController
- 包含发红包收红包功能
- 单聊红包包含小额随机红包和普通红包
- 群红包包含定向红包，普通红包和拼手气红包
- 收红包可以接受各种红包类型包含营销红包
RedpacketUserConfig 红包SDK初始化文件
- 实现红包SDK注册
- 实现当前用户获取
- 实现红包SDK初始化和红包IM消息和透传消息处理
三、Cocoapods支持
环信Demo分为2个Target。
ChatDemo-UI3.0 默认支持支付宝版红包SDK ChatDemo-UI3.0-JDPay 支持钱包版SDK
修改Podfile支持两个红包SDK版本
target 'ChatDemo-UI3.0' do
...
...
pod 'RedpacketAliAuthLib' # 支付宝版红包SDK
end
target 'ChatDemo-UI3.0-JDPay' do
...
...
pod 'RedpacketLib' # 钱包版红包SDK
end
四、红包功能开关
在ChatDemo-UI3.0-Prefix.pch文件中有如下宏定义， 注销掉此宏定义则可以关闭红包功能。
#define REDPACKET_AVALABLE
五、集成准备
1. 导入SDK
导入开源模块
请在环信Demo中获取RedpacketSDK开源部分 在工程中导入RedpacketSDK开源模块
通过Pod更新红包SDK
修改Podfile，如果是支付宝版SDK则加入pod 'RedpacketAliAuthLib' 如果是钱包版SDK则加入pod 'RedpacketLib'
2.通过环信APPKey配置商户信息
修改文件Appdelegate.m
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
...
...
#ifdef REDPACKET_AVALABLE
/**
* TODO: 通过环信的AppKey注册红包
*/
[[RedPacketUserConfig sharedConfig] configWithAppKey:EaseMobAppKey];
#endif
...
...
六、聊天页面实现发红包
用带有收发红包功能的RedPacketChatViewController替换EaseUI的ChatViewController
七、零钱页（钱包版SDK）或者红包记录页（支付宝版SDK）
支付宝版为红包记录 钱包版为零钱页 在SettingsViewController.m中增加此功能
- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath
{
...
#ifdef REDPACKET_AVALABLE
if (indexPath.section == 0) {
cell.textLabel.text = @"零钱";
#ifdef AliAuthPay
cell.textLabel.text = @"红包记录";
#endif
}else if (indexPath.section == 1) {
#else
if (indexPath.section == 0) {
#endif
}
- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath
{
[tableView deselectRowAtIndexPath:indexPath animated:YES];
#ifdef REDPACKET_AVALABLE
if (indexPath.section == 0) {
/** 如果是钱包版SDK则是零钱页，如果是支付宝版SDK则是红包记录页*/
[RedpacketViewControl presentChangePocketViewControllerFromeController:self];
return;
}
#endif
...
...
消息处理
修改文件ChatDemoHelper.m
监听消息
- (void)initHelper
{
#ifdef REDPACKET_AVALABLE
[[RedPacketUserConfig sharedConfig] beginObserveMessage];
#endif
...
...
}
屏闭红包被抢消息的通知
#ifdef REDPACKET_AVALABLE
/**
* 屏蔽红包被抢消息的提示
*/
NSDictionary *dict = message.ext;
needShowNotification = (dict && [dict valueForKey:RedpacketKeyRedpacketTakenMessageSign]) ? NO : needShowNotification;
#endif
后记
未完，待续~~~
