ios 消息 sdk

概述

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

阅读对象

本文档面向所有使用该 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. 将 SDK 中的 framework 添加到工程中,如图: 点击“+”号后出现:

点击“Add Other...”,选中 framework.

点击“Open”.

点击“Finish”

完成 framework 的添加

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

  2. 获取消息代理对象

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

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

#import <PusherFramework/PusherFramework.h>

......

//获取一个消息代理
PusherProxy *proxy = [PusherPool Get];

//从消息代理订阅一个频道(该处订阅的是activity频道)
PusherChannel *channel = [proxy subscribe:@"activity"];

//监听频道的事件(该处监听的是comment-stream-20780事件)
[channel bind:@"comment-stream-20780" callback:^(NSString *message, NSString *event, NSString *channel) {
    NSLog(@"receive message:%@ , event : %@ channel : %@",message,event,channel);
}];

//解除事件绑定 (该处解除的是activity频道的comment-stream-20780事件)
//[channel unbind:@"comment-stream-20780"];

接口说明

PusherPool

接口名称 功能描述
Get 获取消息代理对象

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

create

+(PusherProxy*) Get;

功能:获取消息代理类并初始化。 返回值:PusherProxy对象

PusherProxy

接口名称 功能描述
subscribe 订阅一个频道

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

-(PusherChannel*) subscribe:(NSString*) channel;

功能:订阅一个频道 参数:channel 频道名称 返回值:PusherChannel对象

PusherChannel

接口名称 功能描述
bind 监听频道的事件并进行处理
unbind 接除监听频道的对应事件

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

-(void) bind:(NSString*) event callback:(IMessageCallback) callback;

功能:监听频道事件 参数:event 事件名称 callback 接收到消息的处理函数

-(void) unbind:(NSString*) event;

功能:解除监听频道对应的事件 参数:event 事件名称

IMessageCallback

定义如下:

typedef void (^IMessageCallback) (NSString* message,NSString* event,NSString* channel);

功能:收到消息的回调函数 备注:收到消息后,系统会调用该函数对象,并传入message,event,channel参数,分别对应 消息文本,事件名称,频道名称

results matching ""

    No results matching ""