跟 Red5 类似,Wowza 支持服务扩展,用户可以进行自定义应用程序开发,然后将其作为一个模块部署在 Wowza 服务器。Red5 提供了一个 Eclipse 插件进行应用扩展开发(参见《eclipse 的 Red5 插件安装简介》),Wowza 则提供了一个 IDE。本文简要介绍如何使用 Wowza IDE 开发第一个 Wowza 服务器扩展应用。《安装并使用 Wowza 发布你的 RTMP 直播流》一文介绍了如何安装 Wowza 服务器并提供直播服务,本文将继续以此为例,介绍如何使用 Wowza IDE 开发应用对每个流频道进行监控。
I. 下载 Wowza IDE
官方下载地址 http://wowza.cn/mediaserver/developers,选择适合你自己的平台的版本进行下载。
作者上传了一个 Windows 版本的到 CSDN 资源以做备份,如果看官嫌从官网下载速度太慢,可以点击下载:
II. 安装
Windows 下直接运行步骤 I 下载的 WowzaIDE-2.0.0.exe。
安装好以后,开始 -> 程序 -> Wowza IDE 2 -> Wowza IDE 2 启动 IDE,选择一个目录作为你的工作台,进入后的界面跟 Eclipse 一般无二:
III. 新建项目
File -> New -> Wowza Media Server Project,打开新建项目向导,输入项目名 defonds-live-module:
其中,新项目名 defonds-live-module 也会作为 .jar 的文件名,之后作为一个模块被 Wowza IDE 自动部署在 Wowza 服务器 wowza/lib 目录下;Wowza Media Server /Location 应该指向你的 Wowza 服务器的安装目录。
点击 Next > 按钮,进入新建 WMS 模块类对话框:
包名栏输入:com.defonds.wms.module;
类名栏输入:DefondsLiveModule;
自定义方法名输入:doSomething,这个方法可以被客户端直接调用(NetConnection.call(“doSomething”, null);)。类 DefondsLiveModule 创建以后,你可以使用 doSomething 同样的标签来创建更多自定义方法;
Event Methods 部分是留给你捕捉一系列事件的接口,在这些事件发生时,这些方法将被调用。本文例子里保持默认选择,点击 Finish 按钮。
IDE 会创建 WMS 模块项目,创建模块类,创建一个运行命令并编译和绑定模块类到一个 jar 文件里,这个 jar 文件会被自动部署到 WMS 安装目录下:
最后编辑 DefondsLiveModule 类内容如下:
-
package com.defonds.wms.module;
-
-
import java.util.HashMap;
-
import java.util.Map;
-
-
import com.wowza.wms.livestreamrecord.model.ILiveStreamRecord;
-
import com.wowza.wms.livestreamrecord.model.LiveStreamRecorderMP4;
-
import com.wowza.wms.media.model.MediaCodecInfoAudio;
-
import com.wowza.wms.media.model.MediaCodecInfoVideo;
-
import com.wowza.wms.module.*;
-
import com.wowza.wms.stream.*;
-
import com.wowza.wms.amf.AMFPacket;
-
import com.wowza.wms.application.IApplicationInstance;
-
import com.wowza.wms.application.WMSProperties;
-
-
public class DefondsLiveModule extends ModuleBase implements IModuleOnStream
-
{
-
private Map recorders = new HashMap();
-
private IApplicationInstance appInstance;
-
-
-
public void onAppStart(IApplicationInstance appInstance)
-
{
-
this.appInstance = appInstance;
-
}
-
-
class StreamListener implements IMediaStreamActionNotify3
-
{
-
public void onMetaData(IMediaStream stream, AMFPacket metaDataPacket)
-
{
-
System.out.println("onMetaData[" + stream.getContextStr() + "]: " + metaDataPacket.toString());
-
}
-
-
public void onPauseRaw(IMediaStream stream, boolean isPause, double location)
-
{
-
System.out.println("onPauseRaw[" + stream.getContextStr() + "]: isPause:" + isPause + " location:" + location);
-
}
-
-
public void onPause(IMediaStream stream, boolean isPause, double location)
-
{
-
System.out.println("onPause[" + stream.getContextStr() + "]: isPause:" + isPause + " location:" + location);
-
}
-
-
public void onPlay(IMediaStream stream, String streamName, double playStart, double playLen, int playReset)
-
{
-
System.out.println("onPlay[" + stream.getContextStr() + "]: playStart:" + playStart + " playLen:" + playLen + " playReset:" + playReset);
-
}
-
-
public void onPublish(IMediaStream stream, String streamName, boolean isRecord, boolean isAppend)
-
{
-
System.out.println("onPublish[" + stream.getContextStr() + "]: streamName:" + streamName + " isRecord:" + isRecord + " isAppend:" + isAppend);
-
-
ILiveStreamRecord recorder = new LiveStreamRecorderMP4();
-
recorder.init(appInstance);
-
recorder.setRecordData(true);
-
recorder.setStartOnKeyFrame(true);
-
recorder.setVersionFile(true);
-
-
-
synchronized (recorders)
-
{
-
ILiveStreamRecord prevRecorder = recorders.get(streamName);
-
if (prevRecorder != null)
-
prevRecorder.stopRecording();
-
recorders.put(streamName, recorder);
-
}
-
-
System.out.println("--- startRecordingSegmentByDuration for 60 minutes");
-
recorder.startRecordingSegmentByDuration(stream, null, null, 60*60*1000);
-
-
-
-
-
-
-
-
-
-
-
-
-
System.out.println("onPublish[" + stream.getContextStr() + "]: new Recording started:" + recorder.getFilePath());
-
}
-
-
public void onUnPublish(IMediaStream stream, String streamName, boolean isRecord, boolean isAppend)
-
{
-
System.out.println("onUnPublish[" + stream.getContextStr() + "]: streamName:" + streamName + " isRecord:" + isRecord + " isAppend:" + isAppend);
-
-
ILiveStreamRecord recorder = null;
-
synchronized (recorders)
-
{
-
recorder = recorders.remove(streamName);
-
}
-
-
if (recorder != null)
-
{
-
-
String filepath = recorder.getFilePath();
-
-
-
recorder.stopRecording();
-
System.out.println("onUnPublish[" + stream.getContextStr() + "]: File Closed:" + filepath);
-
}
-
else
-
{
-
System.out.println("onUnPublish[" + stream.getContextStr() + "]: streamName:" + streamName + " stream recorder not found");
-
}
-
}
-
-
public void onSeek(IMediaStream stream, double location)
-
{
-
System.out.println("onSeek[" + stream.getContextStr() + "]: location:" + location);
-
}
-
-
public void onStop(IMediaStream stream)
-
{
-
System.out.println("onStop[" + stream.getContextStr() + "]: ");
-
}
-
-
public void onCodecInfoAudio(IMediaStream stream,MediaCodecInfoAudio codecInfoAudio) {
-
System.out.println("onCodecInfoAudio[" + stream.getContextStr() + " Audio Codec" + codecInfoAudio.toCodecsStr() + "]: ");
-
}
-
-
public void onCodecInfoVideo(IMediaStream stream,MediaCodecInfoVideo codecInfoVideo) {
-
System.out.println("onCodecInfoVideo[" + stream.getContextStr() + " Video Codec" + codecInfoVideo.toCodecsStr() + "]: ");
-
}
-
}
-
-
public void onStreamCreate(IMediaStream stream)
-
{
-
getLogger().info("onStreamCreate["+stream+"]: clientId:" + stream.getClientId());
-
IMediaStreamActionNotify3 actionNotify = new StreamListener();
-
-
WMSProperties props = stream.getProperties();
-
synchronized (props)
-
{
-
props.put("streamActionNotifier", actionNotify);
-
}
-
stream.addClientListener(actionNotify);
-
}
-
-
public void onStreamDestroy(IMediaStream stream)
-
{
-
getLogger().info("onStreamDestroy["+stream+"]: clientId:" + stream.getClientId());
-
-
IMediaStreamActionNotify3 actionNotify = null;
-
WMSProperties props = stream.getProperties();
-
synchronized (props)
-
{
-
actionNotify = (IMediaStreamActionNotify3) stream.getProperties().get("streamActionNotifier");
-
}
-
if (actionNotify != null)
-
{
-
stream.removeClientListener(actionNotify);
-
getLogger().info("removeClientListener: " + stream.getSrc());
-
}
-
}
-
}
IV. 导入例子模块的类
Package Explorer 视图下,右击 defonds-live-module 项目中 src 下的 com.defonds.wms.module -> 选择 Import… -> 在导入对话框里,展开 General 文件夹 -> 选中 File System 后点击 Next > 按钮 -> 点击 Browse… 按钮 -> 浏览至 %Wowza%/examples/ServerSideModules/server 文件夹(这个是 Wowza 服务器安装的一部分) 后确定 -> 勾选 ModuleServerSide.java 后点 Finish 按钮,如下图所示。
这样子我们就把 ModuleServerSide.java 给导入进来了,Package Explorer 视图中双击导入的类名,发现有编译错误:
将 package com.mycompany.wms.module; 换成我们自定义的包名 package com.defonds.wms.module; 即可。
V. 配置 Application.xml
现在我们已经使用 Wowza IDE 构建好了我们自己定义的 defonds-live-module.jar,我们还需要指示 Wowza 服务器加载这个新模块。
编辑 %Wowza%/conf/live/Application.xml 文件,将以下模块定义添加进 部分的结尾:
-
<Module>
-
<Name>DefondsLiveModuleName>
-
<Description>DefondsLiveModuleDescription>
-
<Class>com.defonds.wms.module.DefondsLiveModuleClass>
-
Module>
-
<Module>
-
<Name>ModuleServerSideName>
-
<Description>Defonds ModuleServerSideDescription>
-
<Class>com.defonds.wms.module.ModuleServerSideClass>
-
Module>
这时我们的新模块才正式生效了。如果这一步不明白可以去看《安装并使用 Wowza 发布你的 RTMP 直播流》。
VI. 启动服务
这时我们可以在 Wowza IDE 内部启动 Wowza 服务器了。如果你已经启动了一个 service 模式或者 standalone 模式的 Wowza 服务器,那么你要先将其关闭。点击 Wowza IDE 的工具栏里的 Run 菜单里的 WowzaMediaServer_defonds-live-module 启动 Wowza 服务器。当然你也可以点击 Debug 菜单里的 WowzaMediaServer_defonds-live-module 以 debug 模式启动 Wowza。
这时 Wowza 服务器启动起来了,在 Wowza IDE 的下部的控制台标签里可以看到所有的控制台 log 输出。如同 Eclipse 中的 Tomcat,你可以在控制台窗口中点击关闭图标来停止服务器运行。
VII. 模块调试
现在我们来测试一下新模块的运行情况。使用你的 RTMP Client 发送 RTMP 流到 Wowza,比如 Server URL 为 rtmp://172.21.30.104/live,流名为 xxxxS_2059a0734ccfqvga,成功连接 Wowza 服务器。
Wowza IDE 控制台有 onPublish[live/_definst_/xxxxS_2059a0734ccfqvga]: streamName:xxxxS_2059a0734ccfqvga isRecord:false isAppend:false 输出,这个正是我们 DefondsLiveModule 类里的 StreamListener.onPublish 里定义的,测试成功。
参考资料
阅读(1939) | 评论(0) | 转发(0) |