Q?到RED5的安装目录，扑ֈdoc/templates目录Q该目录中存放了一个标准的RED5应用E序模版myappQ将其复制到RED5安装目录中的webapps目录下那么可以把myapp改ؓmychatQ这个名字就是以后要q接的服务名?br /> Q?在WEB-INF中新Z个文件夹src用来存放E序的源代码Q新Z个classes文g夹用来存攄译后的文?br /> Q、打开Eclipse工作区指定为RED5安装目录下webappsQ然后新Z个项目，目名ؓmyChat.q个时候你应该发现刚才myChat中的文g都被加蝲q来?我们首先把src目录指定为源代码目录Q右键选择src,在弹出的菜单中选择Build Path->Use as Source FolderQ即其指定Z码文件夹。接下来要指定项目的目标目录Q在目名上右键选择PropertiesQ选择Java Bulid Path,在选择Source标签Q在下面的Browse中选择Classes目录Q将其指定ؓ目标目录。然后选择LibrariesQ点击Add External JARsQ将RED5安装目录下的red5.jar包含q来。（java下的jar也最好包含进来）
Q、在Eclipse的左边应该多了WEB-INF/srcq样一个东东，我们要在这里开始写入我们的W一个项目代码。右键选择它，在弹出的菜单中选择New->PackageQ新Z个包QD例，包名可以为lchatQ然后再在生成的lchatq个包上l箋右键选择New->File,输入文g名Application.java。ƈ在徏好的文g中输入以下代码：
package lchat;
import org.red5.server.adapter.ApplicationAdapter;
public class Application extends ApplicationAdapter{
public Double add(Double a,Double b){
return a+b;
}
}
5?br /> 把red5-web.properties文g做以下更改：第一句修改ؓwebapp.contextPath=/myChat
把web.xml文g作以下更改：扑ֈwebAppRootKeyQ将其下面的param-value标签中的g改ؓ/myChat?br /> 把red5-web.xml文g做以下更改：扑ֈbean id=”web.handler”一句，class=”XXX”中的XXX位置修改为org.d5.first.ApplicationQ这hE序以刚才写的Application来运行。删除后面的bean id=”server.handler…整句Q因为我们暂时用不到q个东东?br />
把red5-web.properties文g做以下更改：第一句修改ؓwebapp.contextPath=/myChat
6、重新启动red5
Q、flash里面q行
nc = new NetConnection();
trace(111);
nc.connect("rtmp://localhost/mychat");
nc.onResult = function(obj){
trace("This result is " +obj);
}
nc.call("add",nc,1,2);
出来结果了
表示q接成功
一个最基本的red5qflashE序好?br />
下面是Python代码
from org.red5.server.adapter import ApplicationAdapter
from org.red5.server.api.stream import IStreamCapableConnection
from org.red5.server.api.stream.support import SimpleBandwidthConfigureclass Application(ApplicationAdapter):
def appStart(self, app):
ApplicationAdapter.appStart(self, app)
print 'Python appStart', app
self.appScope = app
return 1def appConnect(self, conn, params):
ApplicationAdapter.appConnect(self, conn, params)
print 'Python appConnect:', conn, params
self.measureBandwidth(conn)
if isinstance(conn, IStreamCapableConnection):
print 'Python setting bandwidth limits'
sbc = SimpleBandwidthConfigure()
sbc.setMaxBurst(8388608)
sbc.setBurst(8388608)
sbc.setOverallBandwidth(2097152);
conn.setBandwidthConfigure(sbc);
return 1def toString(self):
return 'Python:Application'def getInstance(*args):
print 'Arguments:', args
return Application()
]]>
随着来多的朋友开始选择ADSL、Cable Modem或FTTB+ LAN作ؓ首要的上|方式，宽频时代卛_到来Q这使我?#8220;宽频 KTV、媄韌天室、线上电影院、远E教?#8221;的梦惛_成为现实，而与其密切相关的“媒?Streaming Media)”也成了许多h谈论的热门话题，因ؓ“媒?#8221;正是实现q些宽频应用的技术动力?
宽频时代的到来还使得|民们不再满于仅仅作ؓ一Ҏ务的受众Q他们需要更大规模的交流Q从中体C体的价|因此Q许多朋友开始用自己的计机Q搭建网l广播和Ҏ站点。他们充满着满腔的热情，但不可否认的是，中国|民先天技术上的不I让他们在q样的站Ҏ遇到重重险阻Q以至于攑ּ。如何将q种热情在技术的引导下成为动力，q正是我们家用电脑所要做的，所以，在今天，在这里，我就给大家介绍如何打造属于自q媒体服务器?
不过Q在开始正式的媒体服务器架设之前Q请让我们先了解一下流媒体服务器的基础知识?
二、流媒体基础知识
什么是媒体？
目前Q在|络上传输音/视频{多媒体信息有两U解x案，即http或ftp下蝲以及式传输?
http或ftp下蝲使用标准的http和ftp协议Q但׃多媒体信息个头巨大，下蝲一个多媒体文g一般需要几分钟或几时的时_q就造成Z看一个ƈ不知道内容的视频Q首先需要耗费可能比整个视频都要长的时间来完成下蝲。这些被下蝲的文件还必须在下载前制作完成Q放在网l服务器上，q样造成的直接后果就是：|络带宽不断提高Qh们下载的{待旉来少Q但最l还是不能观看网上现场直播?
式传输Ӟ声音、媄像或动画{多媒体信息由流媒体服务器向用户计算l、实时传送，它首先在使用者端的电脑上创徏一个缓冲区Q于播放前预先下载一D资料作为缓Ԍ用户不必{到整个文g全部下蝲完毕Q而只需l过几秒或十数秒的启动g时即可进行观看。当多媒体信息在客户Z播放Ӟ文g的剩余部分将在后C服务器内l箋下蝲。如果网l连接速度于播放的多媒体信息需要的速度Ӟ播放E序׃取用先前建立的一段~冲区内的资料，避免播放的中断，使得播放品质得以l持?
式传输除了能够发送已l制作完成的文g外，q可以通过采集服务器实旉集现场音视频Q推送到媒体服务器端，实时提供l用戗因此，媒体除了能够更好的承担如下载一L多媒体点播服务外Q更能够应用在现场直播、电视{播、突发事件报道等多种对实时性传输要求较高的领域?
有关媒体的厂商
媒体的市场巨大Q世界上许多优秀的厂商都加入此行列，现阶D|是系l集成商竞争的风水宝地。而在通用市场上，竞争的公怸要有三个QMicrosoft、RealNetworks、AppleQ而相应的产品是QWindows Media、Real Media、QuickTime。而近来，以开发Winamp著名的Nullsoft公司也在自己的MP3服务器中加入了视频支持，Ʋ在媒体市场分一杯羹?
׃Apple的服务器和编辑Y件一般都以Mac为操作^収ͼNullsoft的流媒体服务器属于新生不成熟事务Q所以今天在q里我主要给大家介绍一下Microsoft和RealNetworks的品?
媒体的传输协议
大家在观看网上电影或者电视时Q一般都会注意到q些文g的连接都不是用http或者ftp开_而是一些rtsp或者mms开头的东西Qؓ什么是q样呢？实际上，q些和http和ftp一P都是数据在网l上传输的协议，只是它们是专门用来传输流式媒体的协议而已。下面，让我们来看一下现在用的主要的流媒体协议Q?
1. RTSPQReal Time Streaming ProtocolQ，实时媒体协议，它是由RealNetworks和Netscape共同提出的，现在用于RealNetworks的Real Media产品中；
2. PNMQProgressive Networks AudioQ，q也是Real专用的实时传输协议，它一般采用UDP协议Qƈ占用7070端口Q但当你的服务器在防火墙内且7070端口被挡Q且你的服务器把SmartingNetwork设ؓ真时Q则采用http协议Qƈ占用默认?0端口Q?
3. MMSQMicrosoft Media Server protocolQ，q是微Y的流媒体服务器协议，MMS 是连?Windows Media 单播服务的默认方法?
介绍了主要的三个Q可能您q会问，Apple的QuickTime使用哪种协议呢？在多数情况下QQuickTime使用http协议Q但实际上它也由标准的流媒体传输协议Q这是标准RTSP协议Q而Real公司使用的RTSP是自qq开发的?
在流媒体传输中，标准的协议就是RTPQReal time Transport ProtocolQ实时传输协议）、RTCP(Real-time Transport Control ProtocolQ实时传输控制协?、RTSPQReal Time Streaming ProtocolQ实时流媒体协议Q和RSVPQResource Reserve Protocol, 资源预订协议Q，厂商们的产品都是在这些协议的基础上进行研I与开发，限于幅Q在q里我们׃再深入讨Z?
媒体文件和发布格式
有了实时的传输协议，我们应该q能够想刎ͼ只有较小的文件才适合|络实时传输Q那么，媒体文仉用了什么样的压~算法呢Q?
而用Windows操作pȝ的朋友可以看刎ͼ我们观看|上节目时Q它们的后缀名一般是rm、asf、wmv{，q些是媒体的格式。流媒体文g格式l过Ҏ~码Q不仅采用较高的压羃比，q加入了许多控制信息Q光合在网l上边下载边播放Q而不是等C载完整个文g才能播放?
常见的流媒体格式大致有以下几U：
媒体文件格式扩?Video/Audio) 媒体cd与名U?
asf Advanced Streaming format. (Microsoft).
rm Real Video/Audio 文g (Progressive Networks).
ra Real Audio 文g (Progressive Networks).
rp Real Pix 文g (Progressive Networks).
rt Real Text 文g (Progressive Networks).
swf Shock Wave Flash (Macromedia).
mov QuickTimeQApple公司格式Q?
viv Vivo Movie 文g(Vivo Software).
另外q有一个wmv格式Q是Windows Media Video的简Uͼ它与asf文g有稍许区别，wmv一般采用window media video/audio 格式Qasf视频部分一般采用Microsoft MPG4 V(3/2/1?)Q音频部分是windows media audio v2/1Q不q现在很多制作Y仉没有把它们分开Q所以直接更改后~名就能够互相转换为对Ҏ式?
制作完成的流媒体文g需要发布到|络上才能够被别Z用，q就需要以特定方式安排压羃好的媒体文Ӟ而安排流媒体文g的格式就被成为流媒体发布格式。常见的发布格式主要有以下几U：
媒体发布格式扩?媒体cd和名U?
asf Advanced Streaming format.
smil Synchronised Multimedia Integration Language.
ram RAM File.
rpm Embedded RAM File.
asx ASF Stream Redirector/ASF{向器文g
xml eXtensible Markup Language
MPEG-4与流媒体
说到媒体就不能不提及MPEG-4。MPEG-4是当前讨论的焦点之一Q只因ؓ它能够在大的压羃比下实现q似DVD品质的视频和音频效果Q这也是许多朋友认ؓMPEG-4格式肯定比rm清晰的原因。但事实上ƈ不是如此QMPEG-4只是一U视频编码技术，它的清晰度也Ҏ压羃时所选择的码率的不同有较大的改变Q我们见到的MPEG-4格式文g通常?00Kbps压羃生成Q质量当焉了）Qƈ且，MPEG-4q有多种压羃标准Q如Microsoft的asf视频部分是ZMPEG-4的Discrete Cosine Transform (DCT)Q另外还有DivX的免费MPEG-4版本Q开始是破解微Y的格式而来Q。至于音频部分，更是混ؕQMicrosoft采用windows media audio v2/1QDivX采用MP3或者更高质量的AC3{。相比而言QReal或者Apple的格式用的是自己开发的~码Q在相同码率Q特别是低码率下Q不见得比MPEG-4差，采取高码率的rm格式照样清晰可hQ所以大家以后说rm格式清晰度差的观念要改变一下：Q，臛_也要加上条g。而且Q最新的Helix Producer中的Real Video 9采用VP5压羃格式q行~码Q这可比DivX优秀多了Q?
不过Q流媒体服务器开始向MPEG-4格式靠拢是不争的事实QReal最新的Helix开始支持mp4格式文g的服务，而RealOne Player更是只需安装一个插件便可实现MPEG-4格式的播放?
Ҏ与广?
在架设流媒体服务器之前，我们一定要了解一些点播与q播的知识?
Ҏ是客L与服务器之间的主动的q接Q在Ҏq接中，用户通过选择内容目来初始化客户端连接，一个客L从服务器接收一个媒体流Q这个连接是唯一的，其它用户不能占用Q，q且能够对媒体进行开始、停止、后退、快q或暂停{操作，客户端拥有流的控制权Q就像在看媄一栗这U方式由于每个客L各自q接服务器，服务器需要给每个用户建立q接Q对服务器资源和|络带宽的需求都比较大?
q播指的是用戯动接收流。在q播q程中，客户端接收流Q但不能控制，用户不能暂停、快q或后退该流Q广播用的数据发送手D|单播与广播。用单播发送时Q服务器需要将数据包复制多个拷贝，以多个点对点的方式分别发送到需要它的那些用P而用广播方式发送，数据包的单独一个拷贝将发送给|络上的所有用P而不用h否需要，上述两种传输方式会非常浪费网l带宽和服务器资源，因此产生了组播（多播Q技术?
l播Q多播）吸收了上qCU发送方式的长处Q克服了上述两种发送方式的qQ将数据包的单独一个拷贝发送给需要的那些客户Q组播不会复制数据包的多个拷贝传输到|络上，也不会将数据包发送给不需要它的那些客P保证了网l上多媒体应用占用网l的最带宽。但l播不仅需要服务器端支持，更需要有多播路由器乃x个网l结构的支持?
单播与组播（多播Q?
在上面我们已l了解了一些单播和l播的概念，q也是现在流媒体斚w讨论的焦点之一。以我的认识Q点播与q播是一l概念，它们和客L媒体交互的手D；单播和组播又是另外一l概念，它们是流媒体数据在服务器端和|络上的传输方式?
单播发送时Q需要在客户端与媒体服务器之间需要徏立一个单独的数据通道Q从一台服务器送出的每个数据包只能传送给一个客hQ每个用户必d别对媒体服务器发送单独的查询Q而服务器必须向每个用户发送所甌的数据包拯。这U巨大冗余会造成服务器沉重和|络带宽的沉重负担，响应需要很长时_甚至出现不能服务的情c单播可以用在点播和q播上?
三、流媒体服务器硬件准?/strong>
媒体服务器和网站（WebQ服务器一P要经受许多h的同时访问，相比Web服务器来_׃多媒体文仉要更强处理能力，其硬件设备应越一般用于Web的服务器。所以，媒体服务器最好满以下硬件条件?
一颗强劲的“?#8221;。如果计机CPU频率太低Q处理能力过慢，电脑在被多用戯问时我们无法进行其他Q何操作（怿大家寚w些网上视频点播的|站l常当机w有体会Q我们和他们建立的是一L服务器，只是规模些|了Q?
大容量内存和盘。流媒体的制作和发送是pȝ资源的黑z，拥有大容量内存是pȝE_q行的前提；而流媒体文g体积较大Q大量的媒体文g需要更多的存储I间。徏议内存至?56MBQ硬?0G以上?
占用pȝ资源的声卡。好的声卡有助于CPU占用率的降低Qƈ且对录音的质量有很大影响Q用于网上直播）Q徏议用Creative的SB Live!或SB Audigy、Audigy 2pdQ由于笔者自q机器不做服务器（只用来做文章Q没钱升U啊Q，所以只拿普通的集成来演C?
良好的视频捕捉设备。我们的直播节目源就来源于这块设备，推荐使用LeadtekQ丽収ͼ的WinFast TV2000 XP豪华版，它接收信L能力和硬件压~的能力都是比较Z的（因ؓW者没有条Ӟ所以采集设备用了屏q捕捉，不过使用采集讑֤的方法是相同的，所以请大家不要见怪）?
量高的带宽。当然是上网速度快好Q不q我们可以在媒体服务器中对q接数做一个限Ӟ以免当机?
当然Q上面是一个属于自q媒体服务网站必ȝg讑֤Q如果只是和W者一P只是惛_架设媒体服务器q程中学习一把，大可在现有机器的基础上大胆测试?
四、架设流媒体服务器之?/strong>
准备好了gQ下面就开始一步步教大家架设自q媒体服务器。我其分ؓMicrosoft公司的Windows Media和RealNetworks的Real Media两大部分Q都包括直播与点播服务器的徏立，q在最后向大家介绍一下Apple的QuickTime和Nullsoft的流媒体服务器?
׃Microsoft公司的Windows MediaҎ服务必须建立在Server版的操作pȝ上，所以笔者选取Windows .Net Enterprise Server 3647作ؓ此次媒体服务器建立的系l^台。ؓ了比较RealNetworks和Microsoft最C代流媒体服务器的优劣Q笔者采用了它们最新的媒体系l，以下是笔者用的具体软gQ?
操作pȝQWindows .Net Enterprise Server 3647、Windows XP Service Pack 1
媒体YӞWindows Media Services 9.0(Windows .Net Server自带)、Windows Media Encoder 9 Series Release Candidate(׃此Y件在.Net Server下运行不正常Q故安装在XP中，q且只有此Y件安装在XP?、Windows Media Encoder 7.1、Windows Media Player 9.0 Build z903、Helix Universal Server 9.01 FOR Win2k(9.0.2.794)、Helix Producer Plus 9.0.1、RealOne Player 2.0 Build 6.0.11.853?
下面Q就让我们开始吧Q不要走开哦！Q！
WinMedia|上q播服务
单纯的用Windows Media Encoderq个软g卛_实现|上q播服务Q不q，借助于Windows Media ServicesQ利用Windows Media Encoder制作的流媒体文gQ我们的|络q播站功能将更ؓ强大。下面，我们利用Windows Media Encoder单独建立q播站，q将其纳入Windows Media ServicesQ实现更强大的功能?
1. 安装Windows Media Services?
首先安装Windows 2000 Server或者Windows .Net ServerQ然后打开“开始－控制面板Q管理工P理您的服务?#8221;?#8220;开始－控制面板Q添加或删除E序Q添?删除Windowslg”Q徏议用第二种Q，在其中勾?#8220;Web应用E序服务?#8221;Q也是2000 Server中的IIS服务器，单击“下一?#8221;q行dQ?
dIIS完毕后，再次启动d/删除WindowslgE序Qƈ勑֏Windows Media Service，单击详细信息Q在其中选择“用于Web的Windows Media Services Administrator”以启动Windows Media Services的Web理功能Q?000中可能没有这些选项Q只需要安装Windows Media Services卛_Q；
2. 安装Windows Media Encoder?
从微软网站下载Windows Media Encoder 7.1Q由于Windows Media Encoder 9.0无法?Net Server下工作）q行安装Q至此，Windows Media服务的服务器和编码器都已l具备；
3. ?#8220;开始－E序QWindows Media” 启动Windows Media EncoderQ在出现的向导界面中Ҏ自己的需要选择合适的选项Q徏议新?#8220;使用新徏会话向导q播、捕h转换文g”Q选择后单ȝ定；
4. ׃q行的是q播Q所以在下一个弹出的画面中请选择“在附属设备或计算机屏q广播实况事?#8221;Q这L选择能够让Windows Media Encoder直接q行q播或者将其加入Windows Media Service服务Q?
5. 在下一个画面中选择您进行视频或音频捕获的设备，W者没有视频卡Q所以只能选择“屏幕捕获”Q有视频卡的朋友请选择您的视频卡；
6. q播信号必须通过一个有效的端口q行传输Q因此必d它进行设|。Windows Media Encoder默认的端口ؓ8080Q但׃q个端口l常被其它Y件占用，所以徏议朋友们单击“查找可用端口”以换成其它随机端口或者直接输入没有被占用的端口。我选择?#8220;3170”端口Q?
7. 然后开始选择我们q行q播的流媒体质量Q有一个公式您可以参考：媒体配|文件带?#215;最大连接用hQ您的上行带宽（不是下蝲Q是上传Q。您如果?Mbps的上行带宽，选择?00Kbps的配|文Ӟ则允许同?0个观众看到您的广播，由此可见Q流媒体服务对带宽的需求是巨大的；
8. 在这个窗口您可以选择进行广播的媒体存档，以便于以后观看或者进行点播，若只是作为实况广播服务，q且盘I间不大Q您可以不选取Q?
9. “下一?#8221;后，您可以选择是不是添加微软内|的Ƣ迎、休息和再见文gQ我没要这些东西，谁给微Y免费作广告，呵呵Q?
10. 然后Q我们可以给我们的广播节目添加上版权信息Q这些信息在播放Ӟ会出现在Windows Media Player中；
11. 弹出最后一个确认窗口后Q我们最l的q播界面出CQ若是有视频捕捉讑֤Q只要单?#8220;开?#8221;Q我们的q播站就q行hQ只要在客户机IE中输?#8220;mms://服务器的Q端口?#8221;׃弹出media player播放电视。如我徏立的q播站地址是“mms://192.168.0.1:3170Q这些信息您也可以直接在此界面的q接标签中查看；
12. 若是您和我一h有视频捕捉设|，或者想向用h放一D录制好的视频，L?#8220;会话Q属?#8221;Q此面板能够Ҏ有设|过的数据进行调_Q单?#8220;更改”按钮Q在弹出H口中选择视频双的下拉框Q单?#8220;查找文g”Q找到您预先录制好的视频文gQ支持asf、wmv、avi、mpg{格式）Q?
13. 再回到广播界面，点击开始，您的文g可以被|络上的兄弟姐妹看到了，
若是x加更多的文g或设备，请在以上H口单击“更改”旁的“新徏”q行d卛_Q?/span>
14. 您可能觉得到q里我们大功告成了Q实际上q远没有Q这只是最基本的直播广播，我们q需要将其加入Windows Media Services的广播服务中Q以实现更强大的功能。请你的鼠标指?#8220;开始－控制面板Q管理工PWindows Media Services”Q打开Windows Media理器（2000 Server应该是一个Web界面Q。选择左边的服务器后，单击操作菜单中的“d发布点（向导Q?#8221;Q经历欢q页面后Q会出现发布点命名窗口，在其中输入您愿意使用的名字，我输入的?#8220;SOFTICP.COM_Broadcast”Q?
15. 在下一个窗口中Q将让您选择所要发布的内容cdQ如果只是单U的q行媒体直播，选择“~码器（实况）”Q若是想在实冉|中加入其它制作好的文Ӟ请选择“播放列表”Q若是想建立视频Ҏ服务器，请选择“目录中的文g”。由于我有现成的制作好的文gQ所以选择?#8220;播放列表”Q?
16. 选择完了发布内容的类型，p选择发布的方案，我们q行的是|络q播的服务，当然要选择“q播发布?#8221;。在接下来的H口中，我们要选择内容的传递方式，看到了吧Q这ơ我们前面介l的单播和组播的基本概念起了作用Q我们的|络一般不支持l播Q所以要选择“单播”Q?
17. 若是您以前有创徏好的播放列表文gQwsx或htm文gQ，直接在下一个窗口中选择“现有播放列表”Q若是没有，误我一P“新徏播放列表后进行添?#8221;。在dH口中，可以d文g、编码器的实冉|、远E发布点的流媒体、ASP、CGI的动态源{多U媒体，q且q可以添加广告信息以及调整媒体的播放序Q?
18. 完成播放列表的编辑后Q点?#8220;下一?#8221;播攑ֈ表保存成文gQƈ且在下一个窗口中可以选择是否“循环播放”?#8220;无序播放”q些媒体。再l历几个认框，您就完成了Windows Media媒体广播服务器的徏立，Z快捷Q我们就?#8220;完成此向导后启动其它向导”前面的对勑֎掉吧Q?
19. 服务器启动后Q您可以在Windows Media Player中输?#8220;mms://服务器IP/发布点名U?#8221;观看|络q播了。而在Windows Media Services的管理器中，我们可以随时监视媒体的播放情况、添?删除与调整播攑ֈ表、插入广告、发布公告（可以直接生成htm面Q、调整该q播站的属性等操作Qƈ可以随时通过下面的按钮启动与停止q播站以及测试当前流媒体是否正常Q?
此图是用公告向导徏立的发布点公告网，是不是非常方便？
20. 我们q可以通过在浏览器中输入管理器的网址或者直接启动管理工具中?#8220;Windows Media Services(Web)”来对整个媒体服务器q行Web理以及q程理Q其理界面与本地管理除了少几个功能外，几乎没有差别?
q程理q可以对一个服务器l多台服务器q行理?/span>
xQ我们的Windows Media|络q播服务器已l完全徏讑֮毕，您已l拥有了一个具有强大功能的|络q播站，是不是觉得不q瘾Q因有许多优U的媄片想和朋友们׃nQƈ且想让他们能够自q观赏自己喜欢的节目，不受你广播时间表的限Ӟ那么Q跟我来Q我们在此基上再搭徏一个Windows Media视频Ҏ服务器?/span>
]]>
]]>
]]>
Download the source through SVN(Subversion Control)
You need to get the source from a SVN. To some Windows and Mac users this concept may sound confusing. It’s not like downloading a zip from a hyperlink or a specific file. It’s a well known concept in the open-source community so if you’ve used Linux before this is probably familiar to you. The official Papervision3D SVN is hosted at Google Code: You can get the SVN URL for all the links by going to http://code.google.com/p/papervision3d/source/checkout but you can just type this in your SVN application (which I’ll explain below) to get the files you need.http://papervision3d.googlecode.com/svn/trunk/branches/ GreatWhite/
Windows
Many other Papervision3D users have recommended TortoiseSVN and I agree with them, It’s a great tool for SVN source downloading using Windows. You can go to TortoisSVN’s site here: Click here Download the latest version directly from sourceforge: Click here Proceed with the article once you’ve downloaded and installed you can the package. What you need to do now is create a folder, for example inside your work directory or root drive, called “Papervision3D” or “PV3DSource”. You’ll be using this folder to download the SVN. Once you’re inside you need to right click to open the folder properties menu; you’ll notice that there is 2 new options. Select “SVN Checkout” to proceed. You’ll see a input box labeled: “URL of repository” - (This is all you need to be concerned about). Add the SVN URL and let it run, it might take a couple of minutes to complete depending on your connection. Now you have the needed files to continue.Mac
I’m not a Mac user but I did some investigation, this might or might not be useful, so if there is anyone that would like to contribute to this part of the article just leave a comment. I found this SVN client called “svnX” and its opensource so it should get the job done. Here’s a quote from their site:An open-source GUI for Subversion, the compelling replacement for CVS. It allows you to browse your working copies, spot changes, and operate on them, but also to browse logs and revisions of your repositories!You can go to svnX’s site here: Click here The first thing you need to do is click on “SVN Checkout” and set a directory for your Papervision source directory. Once you have done that you should be ago to the “Repositories” window and add the SVN URL. Let the download run and once it’s finished and you see all the files you are ready to continue.
Installing on Flash
This will be split into 2 parts depending on which source you decided to settle on. If you decided on using the Flash Component then continue, if you prefer using the non-compiled source code skip the following step.Using the .mxp Component
(NB: At the time of writing this the .mxp is Version 1.5 and not 2.0)
If you’re still not 100% whether you want to use the component, I might be able to put your mind to rest. There are some benefits to using the component and John Grden from Rock On Flash explains it very well here# Design-time render and editing in Flash IDE # 3 Material types supported - BitmapFileMaterial, BitmaAssetMaterial and MovieAssetMaterial # Creates MovieScene3D and Free or Target camera # Manages resizing / centering of Papervision3D scene [optional] # Dynamic masking to constrain the viewable render area to the bounds of the component [optional] # Full API and access to Scene, Camera, Collada objects to code around # Automatically loads materials via Collada file [when materials list is not given] # New Custom Panel for modifying rotation, camera zoom, camera focus, camera Z at design-timeYou can download the Flash components from Google Code under the downloads tab. Download the latest file, it should look something like this - PV3DComponents_v#####.mxp Once you’ve downloaded the file you can run the .mxp as an executable. It will automatically open “Adobe Extension Manager” and ask you to accept an agreement and then it will install itself. If you have Flash already running you’ll have to restart to see the changes. You can create a new document inside Flash (AS3 Document) to get started. I won’t be showing you how to create anything in this article as the purpose is to show you how to install. What I will do, however, is show you which menus you can access with the Papervision3D .mxp. First off, everything is listed under Window > Components, there you can either choose to create a Papervision 3D scene or Papervision 3D Collada scene. If you’re planning on using the Collada component you can access a very nice GUI menu which lets you set the location, camera, rotation, etc. You can access this by going to Window > Other Panels > PV3DPanel. When you’ve installed the .mxp you already have complete access to the classes in Papervision3D so there is nothing else you need to worry in terms of set-up.
Using the non-compiled source code
If you’ve already installed the .mxp file you can skip this part. Getting the non-compiled source code running with Papervision is painless. You can decide whether you want to set up Papervision3D for any project you create or for individual projects. It is best practice to set up PV3D on each individual project so I’ll explain how to do this. Create a new document inside Flash (AS3 Document) to get started. Click on “Publish: Settings” in your properties menu, if you don’t have a properties menu you can open it through Window > Properties. A publish settings window will open on the “Flash” tab; select “Actionscript” on the left hand side. All you need to do now is click on the “+” symbol and specify the directory of your source. If you used the “svn/trunk/branches/ GreatWhite/src” URL in your SVN client then you can link to the folder you created to download the files, otherwise you need to navigate to the /src dir. And that’s it! Your scene file will now work with the Papervision3D classes.Installing on Flex
The implementation of Papervision3D in Flex is similar of that in Flash in terms of the fact that you can choose between compiled and non-compiled source. We’ll start with the compiled version, (.swc file)Using the compiled .swc library
(NB - The compiled .swc has been removed from the SVN until it goes out of Alpha, it is recommended you use the non-compiled source-code in the meantime since its easier to update. If you still want the .swc you can download it from here)
Using the non-compiled source code
The first thing we need to do is set up a Flex Library project so that we can re-use the same Papervision3D source for every project. This practice is better since you can update, modify and manage the source code all from one location. Create a new Library Project by going to File > New > Flex Library Project Specify a name, something like “Papervision Library” would do, you need something that is descriptive so you can refer back in future projects. The project folder should navigate to the Greatwhite directory under branches in your source folder. Click Next. If you specified the folder correctly you will notice that you have classes listed in your classes tab. Select “src” and you will notice it populating. After you have done this you have to browse to the main source folder and select “src”. Click Fnish and your Papervision3D Flex library project is ready to go! Now that you have your Flex Library Project ready we need to have a project utilize this library. Create a new Project by going to File > New > Flex Project. Specify a name for your project and a project location and leave the rest on default, click Next, specify a debug directory and click Next again. Under the Library path tab click on “Add Project” and you will see that your newly created Flex Library Project for Papervision is listed, select your library project. Click Finish and you’re ready to go! Your Flex Project should now communicate with your Flex Library project, review the image below and see whether your project structure looks similar.Conclusion
When I started this guide I was not aware that there would be so many ways to set up a Papervision3D project, hopefully this is as informative to you as it has been for me. I have done a lot of research on Google and I keep finding what I just explained to you described in 3-4 short sentences, maybe I’m the only one that found this complicated in the beginning. I would love to hear back from you to know whether this article has proved useful.]]>