ios 评论消息库

概述

评论消息库是用来订阅消息的开发工具包,为开发者提供简单易用的接口,可以很方便地接收和发送消息信息。

阅读对象

本文档面向所有使用该 SDK 的开发人员、测试人员以及对此感兴趣的用户,要求开发者对消息的基本功能有一定的解。

开发准备

设备和系统版本

ios8.0 及以上 iphone5 及以上

安装包说明

lib:消息 SDK 开发包,包含播放器 framework 文件,需要在您的工程中进行引用。

快速开发

开发环境配置

  1. 需要准备 iOS 的运行环境(XCode6.0 以上版本,iOS SDK8.0 以上版本),以及硬件 CPU 支持 ARMv7、ARMv7s 或 ARM64 的 iOS 设备。

sdk 包添加

使用 xcode 创建工程的方法如下:

  1. XCode 创建一个 iOS 应用工程。
  2. 将 Framework文件拖至项目中,如图:

完成 framework 的添加

  1. 将 SDK 中的头文件 AliyunPlayerSDK.h 包含到工程中。
#import <MuduComment/MuduComment.h>
  1. 其次按照下面步骤使用sdk进行开发

  2. 获取消息代理对象

  3. 订阅频道
  4. 监听频道发生的事件并处理

下面以 demo 为例来详细说明上面的这些步骤

#import <PusherFramework/PusherFramework.h>

......

//创建评论管理对象,需要传入频道id、用户昵称,用户id。
self.commenter = [[MDCommenter alloc] initWithId:53233 user:@"评论者" userId:@"1500885825jhmgyyvdko"];

//自定义评论头像(可选)
[self.commenter setAvatarUrl:@"http://mudu.tv/assets/img/activity/pc/logo.png"];

//连接频道
BOOL ret = [self.commenter connectToChannel];
if (ret == YES) {
    NSLog(@"连接成功");
} else {
    NSLog(@"连接失败");
}

//开始订阅
BOOL ret =  [self.commenter startSubscribe:^(NSString *message, NSString *subject) {
        // 收到订阅消息
        [self showMessage:message];
    }];
if (ret == YES) {
     NSLog(@"订阅成功");
} else {
    NSLog(@"订阅失败");
}

//发布评论, 发布评论在未进行订阅时也可以进行发布。
[self.commenter pushlishMessage:self.message.text callback:^(NSString *data, NSError *err) {
        if(err == nil) {
            [self showMessage:@"发送成功"];
        } else {
            // 发送失败
            [self showMessage:data];
        }
    }];

//取消订阅
[self.commenter unsubscribe];

接口说明

MDCommenter

评论收发管理对象

下面详细介绍一下成员函数的具体使用:

init

- (instancetype)initWithId:(NSInteger)channelId
                      user:(NSString*)user
                    userId:(NSString*)userId;

功能:根据频道ID、用户昵称、用户ID创建评论管理对象。 返回值:MDCommenter对象

setAvatarUrl

- (void)setAvatarUrl:(NSString*)avatarUrl;

功能:可以自定义头像,不设置时,为默认头像 参数:设置头像的url地址

connectToChannel

- (BOOL)connectToChannel;

功能:将评论管理对象连接至频道。 返回值:返回是否连接成功。

startSubscribe

- (BOOL)startSubscribe:(MessageCallback)callback;

功能:开始订阅评论消息 参数:评论消息收到的回调处理 返回值:消息是否订阅成功

pushlishMessage

- (void)pushlishMessage:(NSString*)message callback:(PubilshReply)callback;

功能:发布评论 参数:发布的消息,和消息发送的结果回调。

unsubscribe

-(void) unsubscribe;

功能:取消订阅频道 备注:取消订阅时,将不会收到评论,但不影响发送评论。

results matching ""

    No results matching ""