当前位置: 首页 > 工具软件 > Red5 > 使用案例 >

red5简介及基础知识

百里文景
2023-12-01

 

  • 简介

 

Red5的主要功能和Macromedia公司的FMS类似,提供基于Flash的流媒体服务的一款基于Java的开源流媒体服务器。它由Java语言编写,使用RTMP作为流媒体传输协议,这与FMS完全兼容。它具有流化FLV、MP3文件,实时录制客户端流为FLV文件,共享对象,实时视频播放、Remoting等功能。用Red5替换FMS后,客户端不用更改可正常运行。

提供red5相关的链接:

官网:http://www.red5.org/

下载地址:http://www.red5.org/downloads/

相关实例:http://trac.red5.org/wiki/Examples

相关文档:http://trac.red5.org/wiki/Documentation

 

 

 

  • 运行部署实例
目前red5最高版本是1.0RC1,我用的是0.9.1Final版,red5具体使用例子网上有很多,在这我推荐一个网址,作者做了一个red5入门的视频,非常适合新手入门: http://plter.com/archives/524
 
注:如果red5还未入门,不建议看后面的内容。
  • ApplicationAdapter类
ApplicationAdapter类是MultiThreadedApplicationAdapter的子类。ApplicationAdapter使用单线程的方式进行方法调用的消息出来,所以其性能不如MultiThreadedApplicationAdapter。MultiThreadedApplicationAdapter类,是Red5应用程序的基础类。它提供了操作SharedObjects 和 streams的方法,还有连接和服务列表,是一个应用程序基本的Iscope。通常应用开发,一般会继承ApplicationAdapter类。
在开发中,我们经常会接触如下几个方法,这些方法都是通过MultiThreadedApplicationAdapter实现:
//Red5应用程序启动时自动执行此方法
public boolean appStart(IScope arg0)
 //Red5应用程序停止时自动执行此方法
public void appStop(IScope arg0)

 //flex客户端连接项目时自动运行的方法

public boolean appConnect(IConnection arg0, Object[] arg1)

 //flex客户端与服务器断开连接时触发的方法

public void appDisconnect(IConnection arg0)

 //flex客户端与服务器连接时运行,与appConnect比较类似

public boolean appJoin(IClient arg0, IScope arg1)

 //flex客户端与服务器断开时运行,与appDisconnect类似

public void appLeave(IClient arg0, IScope arg1)

 

 
  • Red5关键API

Red5提供了很多接口供开发人员进行二次开发:

IConnection:连接对象。每个连接都有一个关联的客户端和域。连接可能是持续型、轮询型、或短暂型。建立此接口的目的,是为了给不同的子类,如 RTMPConnection,RemotingConnection,AJAXConnection, HttpConnection 等,提供基础通用的方法。它提供getClient()方法来获取客服端对象。

IScope :每个Red5应用程序至少有一个域,用来搭建处理器、环景、服务器之间的连接。域可以构成树形结构,所有客户端都可以作为其节点共享域内的对象(比如流和数据)。所有的客服端(client)通过连接(connection)连接到域中。对于单一域,每个连接对应一个客服端,每个客服端对应一个id,简单的应用,操作就针对一个id和一个连接进行。

IServiceCapableConnection :获取有效连接。代码中先获取到连接实例,然后判断是否是有效连接并强制类型转换,之后调取客户端相应函数。

IClient :客户端对象代表某单一客户端。一个客户端可以和同一主机下不同的域分别建立连接。客户端对象和HTTP session 很相像。可以使用IClientRegistry.newClient(Object[])方法来创建IClient对象。

ApplicationAdapter:ApplicationAdapter是应用层级的IScope。若要处理流进程,需实现 IStreamAwareScopeHandler接口中的相应处理方法。ApplicationAdapter还提供了有效的事件处理机制,来进行截取流、确认用户等操作。同时,其子类中引入的方法均可在客户端通过 NetConnection 调取。在Aodbe 的FMS 中必须在服务器端维护客户端对象,与之相较,Red5 为您的远程请求提供了更加方便快捷的操作方法。

 
 
 
  • 简单实例
【flex客户端连接red5服务器】
 
Actionscript提供了NetConnection与服务器连接,连接之后可以调用red5的方法,也可以指定client对象供red5调用。
下面这段代码是连接red5中某个自己创建的项目,并且通过事件监听连接状况:
//创建NetConnection实例
var netConn:NetConnection = new NetConnection();
//指定rtmp地址,并且向服务器传递一个参数值"hello"
netConn.connect("rtmp://localhost/chatroom","hello");
//添加NetStatus事件监听连接
netConn.addEventListener(NetStatusEvent.NET_STATUS,function connStatus(e:NetStatusEvent):void{
						switch(e.info.code){
							//连接成功
							case "NetConnection.Connect.Success":
								l_connStatus.text = "连接成功";
								break;
							//服务器断开
							case "NetConnection.Connect.Closed":
								l_connStatus.text = "连接断开";
								break;
							//能连上,但被拒绝访问
							case "NetConnection.Connect.Failed":
								l_connStatus.text = "连接拒绝";
								break;
							default:
								break;
						}
					});
把这段代码放到flex事件中,当触发事件时就会连接red5.
 
 
【客户端调用服务器方法】
客户端调用服务器方法非常常用,有时你会主动向服务器获取视频资源,或者向服务器发送消息信息。
NetConnection的call(command:String,responder:Responder,...arguments)用于调用服务器方法,
command  指定被调用的服务器的方法名
responder 可选对象,用于处理服务器的返回值,这是回调的形式,所以需要实例化Responder对象,然后在对象体内创建一个方法获取服务器返回值,如果没有返回值,则方法参数为空即可。
arguments 可选参数,当在远程应用程序服务器上执行 command 参数中指定的方法时,这些参数将被传递给该方法
 
下面这段代码介绍向服务器发送消息的方法:
/**
			 * 发送消息
			 * */
			protected function sendMsg():void
			{
				netConn.call("sendMessage",new Responder(function result():void{
				}),uName,txt_msg.text);
			}
 服务器必须有一个sendMessage方法,并且带两个参数,以获取客户端传入的参数值:
public void sendMessage(String userName,String message){
   ....
}
 因为当前方法没有返回值,所以Responder内的result方法参数为空,假如sendMessage方法返回String,则需要把Responder改成这样:
new Responder(function result(str:String):void{
   ....
})
 
 
【服务器调用客户端】
比如一个会议系统,某个客户端下线,服务器必须及时通知其它客户端该客户下线的通知,所以必须主动访问客户端。
客户端为了允许服务器调用,需要在NetConnnection中指定client属性,该属性就是指定服务器能访问客户端的对象范围,可以指定某个方法,也就是服务器只能访问那个方法,也可以把整个mxml对象都指定为client,这样服务器就可以访问mxml对象内的元素了。
通常指定client是在连接服务器的时候:
//指定连接client,方便red5调用当前客户端的方法
netConn.client = this;
 在flex中创建一个普通的方法:
/**
			 * 【供red5调用的方法】
			 * 客户端与red5连接时,red5向客户端返回的消息
			 * */
			public function connection_msg(str:String):void{
				Alert.show(str);
			}
 
red5服务器端需要IServiceCapableConnection.invoke调用客户端,它是IConnection的子接口,所以只要找到IConnection就可以调用IServiceCapableConnection了:
invoke(String str,Object[] objs)方法第一个参数表示客户端的方法名,第二个参数表示客户端方法中必须传入的参数值。
public boolean appConnect(IConnection arg0, Object[] arg1) {
	callClient(arg0,"通知客户端连接成功");
	return super.appConnect(arg0, arg1);
}

/**
	 * Function  : red5调用客户端connection_msg方法,返回相应信息
	 * @author   : bless<505629625@qq.com>
	 * @param conn
	 * @param str
	 */
	private void callClient(IConnection conn,String str){
		if(conn instanceof IServiceCapableConnection){
			IServiceCapableConnection sc = (IServiceCapableConnection) conn;
			sc.invoke("connection_msg", new Object[]{str});
		}
	}
 
 
【通知其它在线用户】
通过IConnection.getScope()获取域中其它用户,再一次迭代通知每一个域中的客户
public boolean appConnect(IConnection arg0, Object[] arg1) {
     //通知其它用户该用户上线
     notifyAppConnect(arg0.getScope(),"用户A上线啦");
}

/**
	 * Function  : 通知其它客户,用户上线信息
	 * @author   : bless<505629625@qq.com>
	 * @param scope
	 */
	private void notifyAppConnect(IScope scope,String userName){
		//遍历所有链接到服务器的客户端
		Collection<Set<IConnection>> col = scope.getConnections();
		for (Set<IConnection> set : col) {
			for (IConnection iConnection : set) {
				//通知有所客户端上线用户信息
				if(iConnection instanceof IServiceCapableConnection){
					IServiceCapableConnection sc = (IServiceCapableConnection) iConnection;
					sc.invoke("otherConnection_msg", new Object[]{userName});
				}
			}
		}
	}
 
【服务器指定计划任务】
计划任务可以让服务器定时循环做一些事,比如定时向客户端发送消息提示之类的。
MultiThreadedApplicationAdapter.addScheduledJob(int interval, IScheduledJob job)
interval表示多少毫秒运行一次该计划,但是是毫秒哦
job是IScheduledJob接口,你必须实现IScheduledJob接口
比较常用的方式是在当前服务器核心类实现IScheduledJob接口并且重写execute(ISchedulingService arg0)方法:
public class HelloRed5 extends ApplicationAdapter implements IScheduledJob{
          public boolean appStart(IScope arg0) {
		System.out.println("启动 appStart");
		//添加计划任务
		this.addScheduledJob(10000, this);
		return super.appStart(arg0);
	  }
          
           /**
	 * IScheduledJob接口实现方法
	 */
	@Override
	public void execute(ISchedulingService arg0)
			throws CloneNotSupportedException {
                //运行定时任务的实际方法
		callEvery(this.getScope(),"运行下计划任务...");
	}
}
 
 
把这几种交互方式和基本概念掌握清楚,就能编写一个简单的聊天程序了。
 
 
 
 类似资料: