User manual MACROMEDIA FLASH MEDIA SERVER 2-CLIENT-SIDE ACTIONSCRIPT LANGUAGE REFERENCE FOR FLASH MEDIA SERVER 2

[. . . ] Client-Side ActionScript Language Reference for Flash Media Server 2 Trademarks 1 Step RoboPDF, ActiveEdit, ActiveTest, Authorware, Blue Sky Software, Blue Sky, Breeze, Breezo, Captivate, Central, ColdFusion, Contribute, Database Explorer, Director, Dreamweaver, Fireworks, Flash, FlashCast, FlashHelp, Flash Lite, FlashPaper, Flash Video Encoder, Flex, Flex Builder, Fontographer, FreeHand, Generator, HomeSite, JRun, MacRecorder, Macromedia, MXML, RoboEngine, RoboHelp, RoboInfo, RoboPDF, Roundtrip, Roundtrip HTML, Shockwave, SoundEdit, Studio MX, UltraDev, and WebHelp are either registered trademarks or trademarks of Macromedia, Inc. and may be registered in the United States or in other jurisdictions including internationally. Other product names, logos, designs, titles, words, or phrases mentioned within this publication may be trademarks, service marks, or trade names of Macromedia, Inc. or other entities and may be registered in certain jurisdictions including internationally. [. . . ] You can't publish and play data over the same stream at the same time. For example, if you are publishing on a stream and then call NetStream. play(), an implicit NetStream. close() method is called; the publishing stream then becomes a subscribing stream. However, you can create multiple streams that run simultaneously over the same connection: one stream publishes and another stream plays. Example The following example shows how a publishing client and a subscribing client can connect to the Flash Media Server and then open an application stream for sending (publishing) or receiving (playing) data over this connection. // Publishing client contains this code. my_nc:NetConnection = new NetConnection(); // create NetConnection object my_nc. connect("rtmp://myRTMPServer. myDomain. com/app"); // connect to server my_ns:NetStream = new NetStream(my_nc); // open app stream within my_nc my_ns. publish("myWeddingVideo"); // publish data over this stream // Subscribing client contains this code. /* Note that the connection and stream names are the same as those used by the publishing client. This is neither required nor prohibited, because the scripts are running on different machines. However, the parameters used with connect() and play() below must be the same as those used with connect() and publish() above. */ my_nc:NetConnection = new NetConnection(); my_nc. connect("rtmp://myRTMPServer. myDomain. com/app"); my_ns:NetStream = new NetStream(my_nc); my_ns. play("myWeddingVideo"); For more examples, see the NetStream class entry and Video. attachVideo(). See also NetConnection class, NetStream. attachAudio(), NetStream. attachVideo(), NetStream. play(), NetStream. publish(), Video. attachVideo() 80 Client-Side ActionScript Language Reference NetStream. attachAudio() Availability Flash Player 6. Flash Communication Server MX 1. 0. Usage public attachAudio(source:Microphone) : Void Parameters source The source of the audio to be transmitted. Valid values are a Microphone object and null. Returns Nothing. Description Method; specifies whether audio should be sent over the stream (from a Microphone object passed as source) or not (null passed as source). This method is available only to the publisher of the specified stream. You can call this method before or after you call the NetStream. publish() method and actually begin transmitting. Subscribers who want to hear the audio must call a NetStream. play() method. Subscribers can also attach their incoming audio to a movie clip and then create a Sound object to control some aspects of the sound. For more information, see MovieClip. attachAudio(). Example The following code attaches a microphone to a network stream: my_netstream. attachAudio(active_mic); See also Microphone class, MovieClip. attachAudio(), NetStream. attachVideo(), NetStream. publish(), NetStream. receiveAudio() NetStream class 81 NetStream. attachVideo() Availability Flash Player 6. Flash Communication Server MX 1. 0. Usage public attachVideo(source : Camera [, snapShotMilliseconds : Number]) Parameters source The source of the video transmission. Valid values are a Camera object (which starts capturing video) and null. If you pass null, Flash stops capturing video, and any additional parameters you send are ignored. snapShotMilliseconds An optional integer that specifies whether the video stream is continuous, a single frame, or a series of single frames used to create time-lapse photography. If this parameter is omitted, Flash captures all video until you issue my_ns. attachVideo(null). If you pass 0, Flash captures only a single video frame. Use this value to transmit "snapshots" within a preexisting stream. Flash interprets invalid, negative, or nonnumeric arguments as 0. NO TE If you pass a positive number, Flash captures a single video frame and then appends a pause of length snapShotMilliseconds as a "trailer" on the snapshot. Use this value to create time-lapse photography effects. Returns Nothing. Description Method; starts capturing video from the specified source, or stops capturing if source is null. This method is available only to the publisher of the specified stream. 82 Client-Side ActionScript Language Reference After attaching the video source, you must call NetStream. publish() to actually begin transmitting. [. . . ] The connection attempt failed; for example, the server is not running. The client does not have permission to connect to the application, or the application expected different parameters from those that were passed, or the application specifically rejected the client. The connection attempt succeeded. NetConnection. Connect. AppShutdown Error NetConnection. Connect. Closed NetConnection. Connect. Failed Status Error NetConnection. Connect. Rejected Error NetConnection. Connect. Success * Status This information object also has a description property, which is a string that provides a more specific reason for the failure. This information object also has an application property, which contains the value returned by the application. rejectConnection() server-side method. NetStream information objects The following messages notify you when certain NetStream activities occur: 152 Client-Side Information Objects Code property NetStream. Buffer. Empty Level property Status Meaning Data is not being received quickly enough to fill the buffer. [. . . ]