注：从Wowza Streaming Engine 4.2开始，你可以通过Wowza Streaming Engine管理界面上的Streaming Target来进行CDN推送的相关配置。

Wowza Streaming Engine 的Push Publishing 技术及其API可以让你通过Real Time Messaging Protocol(RTMP)、Apple HLS (cupertino), Adobe HDS (sanjose)、MPEG-2 Transport Stream (MPEG-TS)以及Real-time Transport 协议(RTP)将一个直播流推送到另一个远端的服务器上， 例如CDN或其它运行Wowza Streaming Engine^® 或 Adobe^® Media Server的服务器，或组播网络上。从而可以支持更大规模的用户。

在Wowza Streaming Engine4.2之前，Push Publishing技术使用一个映射文件来建立输入流到推送目的地的映射，同时这个映射文件可以被动态更新。此外，一个输入流可以被推送到多个目的地址上。

注意:

• 这篇文章仅针对Wowza Streaming Engine™ 4.0及更高版本。
  
  
• 关于推流到更多外部第三方系统的Map文件示例，请参考Push Publishing destinations (with sample mapping file information).
  
  
• 你可以下载使用Push Publishing API的例子模块(下载例子程序 PushPublishExampleModule_4.0.zip)。你可以看看压缩包中的README.html文件，以了解更多。

内容提纲

---

关于安装
配置ModulePushPublish 模块
配置 PushPublishMap.txt 映射文件
关于Push的传输协议(profile)
Debugging connections
Push Publishing 的配置参数
Push Publishing API
Push Publishing 的目的服务器

关于安装

---

只要启动Wowza Streaming Engine 4就行，不需要其它任何附加的安装步骤。这个Push Publishing功能已经被集成到Wowza Streaming Engine 软件中了。

配置 ModulePushPublish 模块

---

ModulePushPublish 模块将监听所有进入Wowza Streaming Engine的输入流。

1. 在Wowza Streaming Engine Manager管理界面中，点击你希望启用这个Push Publishing功能的直播应用。
   
   
2. 在直播应用的页面，点击Modules tab页。
   注意: 只有高级权限管理帐号才能看到Modules tab 页。要了解更多，请看Manage credentials.
3. 在Modules tab页，点击Edit，再点击Add Module, 然后填写以下模块信息:
   

   Name	ModulePushPublish
   Description	ModulePushPublish
   Fully Qualified Class Name	com.wowza.wms.pushpublish.module.ModulePushPublish

   
   
   
4. 点击 Add, 然后再点击 Save，再然后按提示信息点击application的Restart。

配置 PushPublishMap.txt 映射文件

---

[install-dir]/conf/PushPublishMap.txt文件用于在源流和推送目的地之间建立映射关系(即什么流推送到什么地方去)。 文件中的每一行都代表了一个源流及其推送的目的地。如果你要把一个源流推送到多个目的地，只要多加几行即可。 在Wowza Wowza Streaming Engine 运行过程中，这个映射文件可以被动态的修改，但正在被推送的任务是不受影响的。 受影响的只是在文件被更新完成后才进入Wowza Streaming Engine 的输入流。

注意:

• PushPublishMap.txt文件现在对参数名和参数值支持双引导(")，以兼容JSON规范，以前没有用双引导的映射文件在今后一段时间依然可以用，你可以更新这个文件，添加这个双引号，以保证能和未来版本的PushPublish模块兼容。
  
  
• 当前，Streaming Engine Manager 的管理界面还不支持对[install-dir]/conf/PushPublishMap.txt 文件的编辑。

从源流到目的地的映射

映射文件中的一条Push任务的格式如下:
例如，如果要采用RTMP协议将一个叫做myStream的流推送另一个运行Wowza Streaming Engine的服务器，PushPublishMap.txt文件中的这个Push任务就类似如下:
一个源流可以被推送到多个目的地，如果要这么做，为这个源流添加多条推送任务即可。例如要把myStream推送到一个运行Wowza Streaming Engine服务器，并且同时以MPEG-TS推送到一个组播网络，你可以在map文件加入以下推送任务:

不同的'profile'的其它附加配置参数

每一个推送任务中的Profile决定了采用什么协议进行推送，而每一种不同的Profile都有一些各自附加的配置参数。 要了解更多，请参考关于Push的传输协议(profile).

针对每个Wowza应用的Map文件

默认情况下，所有Wowza的应用共用一个Map文件。 如果要为每一个Wowza应用使用单独的Map文件，只要将[install-dir]/conf/PushPublishMap.txt文件拷贝到[install-dir]/conf/[application]文件夹下(每一个应用的配置根目录下)，然后在Application.xml中增加一个参数pushPublishMapPath，将其配置为${com.wowza.wms.context.Application}即可。 关于这个配置参数，请看Push Publishing 的配置参数中的例子。 如果没有明确定义pushPublishMapPath参数，默认就会使用[install-dir]/conf/PushPublishMap.txt文件。

关于Push的传输协议(profile)

PushPublishMap.txt文件中的每一个推送任务中的profile定义了视频流将被如何推送。 每一个profile都有一些各自的附加参数，可以添加到映射信息中。这个章节介绍了这些profile以及它们的附加参数：

• rtmp - 使用RTMP协议推流到Wowza Streaming Engine 或 Adobe Media Server。
• rtmp-akamai - 使用RTMP协议推流到Akamai HD Network。
• rtmp-limelight - 使用RTMP协议推流到Limelight CDN。
• cupertino-akamai - 使用Apple HLS协议推流到Akamai HD Network。
• sanjose-akamai - 使用Adobe HDS 协议推流到Akamai HD Network。
• rtp - 使用native RTP 协议推流。
• mpegts - 使用MPEG-TS协议推流。

---

Profiles: cupertino-akamai 和 sanjose-akamai

Akamai HTTP 协议的播放URL格式

设置了akamai.eventName的Primary播出流:

没有设置akamai.eventName的Primary播出流:
设置了akamai.eventNameBackup播出流:
没有设置akamai.eventName的冗余播出流:
设置了akamai.eventName的Primary stream in adaptive group:
没有设置akamai.eventName的Primary stream in adaptive group:
设置了akamai.eventName的Backup stream in adaptive group:
注意:

• In cases where both akamai.destinationServer:"redundant" and adaptiveGroups:"[groupName]" are specified, a redundancy manifest/playlist won't be generated for the stream and the adaptive group manifest/playlist should instead be used for playback, since both the primary and backup streams will be listed there as well.
  
  
• Akamai encoder documentation indicates that their ingest servers only support 6-second chunk durations in the current version of their product for Adobe HDS. The Streaming Engine default chunk duration is 10 seconds for HDS. Therefore, we recommend changing the sanjoseChunkDurationTarget property value in Wowza Streaming Engine Manager to 6000 (6 seconds) for applications configured to push HDS streams to Akamai. Also, to ensure that accurate chunks durations are produced, we recommend that the the source stream is encoded with 1, 2, or 3-second keyframe intervals.

Profile: rtp

参数名字	描述信息
streamName	SDP 文件的文件名
host	目的服务器的主机名或IP地址
videoPort	目的服务器的视频端口
audioPort	目的服务器的音频端口
timeToLive	当通过组播推流时,这是UDP包的TTL(默认是63)
streamWaitTimeout	当一个输入流进入时，这是等待这个流被识别和 接受的毫秒时间(默认是5000)

Profile: mpegts

参数名字	描述信息
streamName	SDP文件的文件名
host	目的服务器的主机名或IP地址
port	目的服务器的端口
timeToLive	当通过组播推流时,这是UDP包的TTL(默认是63)
rtpWrap	设置为true 以将MPEG-TS流封装在RTP包中(默认是false)

推送到目的服务器时的调试

要调试流传输建立连接时可能遇到的问题,你可以为每一个推送任务配置两个级别的Debug日志: debugLog 和 debugPackets。当使用它们时,debugLog 记录了高层面(high-level)的连接信息以及连接状态。 专业的RTMP连接信息则位于数据包层面，debugPackets 记录了详细的每一个包的信息。 下面是一个同时采用了这两个级别的log的映射信息:

对于一些更复杂的debug需求，请参考如何对Wowza的Push Publishing功能进行调试。

Push Publishing 的配置参数

---

你可以为Push Publishing功能添加下面介绍的配置参数，来对它的功能进行微调，请参考下面的连接学习如何在Wowza的管理界面 配置这些参数。

---

API

Wowza Streaming Engine中的Push Publishing功能提供了一个底层的(low-level)的应用程序接口(API)，你可以用它创建你自己的推送程序。这些API的Javadoc文档被包含在Wowza安装目录的documentation/serverapi 文件夹下。 请看其中的com.wowza.wms.pushpublish.* 类包部分。

Wowza为您提供了一个自定义Module的例子，你可以下载。它展示如何用Push Publishing API向一个远端的服务器推送一个RTMP直播流。(下载 PushPublishExampleModule_4.0.zip)。 这个module 监听Wowza的输入流，然后将它推送到当前Wowza应用，新推送的流名为push-[streamName]。 当源流停止时(unpublished)，它会停止推送。

要安装这个module，请参考压缩包中的README.html文件。

Push Publishing 的目的服务器

---

下面的文章介绍了一些Map文件的例子，包括了Wowza Streaming Engine支持的所有推送目的服务器：

• 关于Wowza Push Publishing功能所支持的推送目的服务器或CDN