FMS客户端ActionScript 语言的参考

FMS客户端ActionScript 语言的参考
2009年11月17日
　　Macromedia Flash Media Server提供了两种应用程序接口(APIs),客户端ActionScript API 和服务器端 ActionScript API 。本文档将阐述客户端 API。
　　这份帮助文档是设计用来配合Macromedia Flash ActionScript 帮助文档一起使用的。您可以参阅Flash帮助文档以了解一般性的脚本知识。使用本文档，可以帮助您在Flash应用程序中添加Flash Media Server功能。
　　对于如何开发Flash Media Server应用程序，以及理解如何在客户端和相配套的服务器端创建对象的更多信息，请您参阅《开发媒体应用程序》一书。
　　　　注意：
　　　　这份帮助文档中的很多实例代码使用 ActionScript.2.0语法。
　　　　ActionScript 类:
　　下表列出了《Flash Media Server　2客户端语言参考指南》一书中的所有类：
　　　　Camera类:
　　　　让您从连接到正在运行 Macromedia Flash Player播放器的计算机上的摄像头捕获视频。
　　　　Microphone类:
　　　　让您从连接到正在运行 Macromedia Flash Player播放器的计算机上的麦克风捕获音频。
　　　　MovieClip 类:
　　　　让您指定一个声音的来源，是通过从本地(Microphone对象)捕获，还是通过从运行Flash Media Server的应用程序中流出(NetStream 对象)。
　　　　NetConnection 类:
　　　　管理Flash Player与服务器之间的双向连接，它可以让您连接到Flash Remoting或者Flash Media Server。
　　　　NetStream 类:
　　　　创建一个Flash Player和Flash Media Server之间的单向连接，使用 NetConnection 对象可以创建一个有效的此连接。
　　　　SharedObject 类:
　　　　允许在多个本地或者远程的SWF客户端之间共享的即时数据。
　　　　System类:
　　System 类包含多个与发生在用户计算机上的某些操作相关的属性，如具有共享对象的操作、摄像头和麦克风的本地设置和剪贴板的设置。
　　　　 Video类
　　　　　让您在 SWF 文件中显示实时或以前录制的视频流。
　　（译者说明：原英文版本以下有一个有关Camera类、方法的列表，对相关属性,方法作简要说明,由于篇幅较长，且不涉及具体语法，故在译文中省略。）
　　Camera类
　　可用性
　　■Flash Player.6 。
　　■Flash Media Server.(非必需)
　　　　Camera类可以让您从连接到正在运行 Macromedia Flash Player的计算机上的摄像头捕获视频。当您用它配合Flash Media Server一起使用时, 这个类还可以让您传送，显示, 和可选择地记录被捕获的视频。利用这些功能, 您可以开发媒体应用程序 , 例如视频会议, 包含视频的即时通讯，等等。Flash提供了一个类似的音频功能; 如果您想了解更多关于音频的信息, 请您参阅Micorophone类。
　　　　您也可以不必配合服务器使用Camera对象，例如,例如监视来自连接到本地系统的 Web 摄像头的视频输入。
　　　　注意：
　　　　当 SWF 文件试图访问Camera.get()返回的摄像头时, Flash　Player编译器将显示一个隐私对话框，让用户选择允许还是拒绝对Camera的访问。 (对于Camera类，请确定您的舞台尺寸不小于215 x 138图素，这是 Flash显示对话框所必需的最小尺寸。) 最终用户和管理员可以禁用单个站点和所有的对Camera的访问。
　　Camera类方法摘要：
　　Camera.get()：
　　返回对用于捕获视频的 Camera 对象的引用。
　　Camera.setKeyFrameInterval()：
　　设置视频传输的帧速和压缩算法。
　　Camera.setLoopback()：
　　设置指定是否对从本地捕获的视频流使用压缩。
　　Camera.setMode()：
　　设置所捕获视频的外观,包括高度，宽度和帧速。
　　Camera.setMotionLevel()：
　　设置触发Camera.onActivity(true)事件所必需的运动量。
　　Camera.setQuality()：
　　设置输出视像输送的最大带宽以及画面质量。
　　为Camera类的属性属性摘要
　　Camera.activityLevel
　　一个从 0 到 100之间的数值，用来指定Camera侦测运动所需要的数值。
　　Camera.bandwidth
　　目前向外传输视频的最大带宽, 单位为bytes。
　　Camera.currentFps
　　Camera捕获数据的每秒速率。
　　Camera.fps
　　您需要的Camera捕获数据的速率。
　　Camera.height
　　所捕获视频的高度, 单位是图素。
　　Camera.index
　　Camera的索引, 是从 Camera.names方法中返回的一个数组。
　　Camera.motionTimeOut
　　Camera侦测画面停止所需要的时间，毫秒，此时触发 Camera.onActivity(false) 事件的时间。
　　Camera.muted
　　一个布尔值，检测用户允许还是拒绝对Camera的访问。
　　Camera.name
　　检测摄像头硬件的名称。
　　Camera.names
　　类属性，一个包含所有可用的视频采集设备的字符串数组,包括视频卡和摄像头。
　　Camera.quality
　　一个数值，描述一个基于所应用的视频帧速压缩的画面质量。
　　Camera.width
　　所捕获视频的宽度, 单位为图素。