环信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客户端的集成(九)
这一篇主要说一下环信的 环信红包接入文档(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。

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

后记

未完,待续~~~

美景

推荐阅读更多精彩内容

  • 版本记录 前言 很多app种都集成环信做第三方信息通讯工具,这里我们就看一下环信的主要功能和集成方法。先给出环信3...
    刀客传奇阅读 325评论 3 2
  • 版本记录 前言 很多app种都集成环信做第三方信息通讯工具,这里我们就看一下环信的主要功能和集成方法。先给出环信3...
    刀客传奇阅读 585评论 1 0
  • 小区里的路灯依然非常昏暗,现在已经是夜里9点多。广场舞终于结束了,一群群的人沿着面前的大路走了过来。 “他们来了!...
    王团长1阅读 120评论 1 3
  • 我们聊得很畅快 似乎双方都有一种吸引力 在你推开门之前 我们还是陌生人 其实只需简短的沟通 但我们却聊了好久 从行...
    喵喵诗茵阅读 63评论 2 2
  • 第四部分 1.孩子生病,避免把大人的担忧和紧张带给孩子,培养孩子对生活的乐观和热情是最重要的,也是治愈的基础之一。...
    真小凝阅读 19评论 0 1