这是本文档旧的修订版!


环信红包接入文档(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消息和透传消息处理

环信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

导入SDK

导入开源模块

请在环信Demo中获取RedpacketSDK开源部分 在工程中导入RedpacketSDK开源模块

通过Pod更新红包SDK

修改Podfile,如果是支付宝版SDK则加入pod 'RedpacketAliAuthLib' 如果是钱包版SDK则加入pod 'RedpacketLib'

通过环信APPKey配置商户信息

修改文件Appdelegate.m

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
...
...

#ifdef REDPACKET_AVALABLE
    /**
     *  TODO: 通过环信的AppKey注册红包
     */
    [[RedPacketUserConfig sharedConfig] configWithAppKey:EaseMobAppKey];
#endif

...
...

用带有收发红包功能的RedPacketChatViewController替换EaseUI的ChatViewController

支付宝版为红包记录 钱包版为零钱页 在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


下一页:APNs推送