MACROMEDIA FLASH MEDIA SERVER 2-SERVER-SIDE ACTIONSCRIPT... Скачать руководство пользователя страница 129

Страница: 129 / 234

SharedObject class

129

Description

Method; locks the shared object instance. This method gives the server-side script exclusive
access to the shared object; when the

SharedObject.unlock()

method is called, all changes

are batched and one update message is sent, through the

SharedObject.onSync

handler, to

all the clients that subscribe to this shared object. If you nest the

SharedObject.lock()

and

SharedObject.unlock()

methods, make sure there is an

unlock()

method for every

lock()

method; otherwise, clients are blocked from accessing the shared object.

You cannot use the

SharedObject.lock()

method on proxied shared objects.

Example

The following example locks the

myShared

shared object, executes the code that is to be

inserted, and then unlocks the object:

var myShared = SharedObject.get("foo");
myShared.lock();
// Insert code here that operates on the shared object.
myShared.unlock();

SharedObject.mark()

Availability

Flash Media Server 2.

Usage

mySO

.mark(

handlerName

p1, ..., pN

)

Parameters

handlerName

Calls the specified function property on the client-side SharedObject

instance. For example, if the

handlerName

parameter is

onChange

, the client invokes the

SharedObject.onChange()

method with all the

p1, ...,pN

parameters.

NOT

Do not use a built-in method name for a handler name. For example, the subscribing
stream will be closed if the handler name is

Содержание FLASH MEDIA SERVER 2-SERVER-SIDE ACTIONSCRIPT...

Страница 1: ...Server Side ActionScript Language Reference...

Страница 2: ...does not imply that Macromedia endorses or accepts any responsibility for the content on those third party sites Sorenson Spark video compression and decompression technology licensed from Sorenson M...

Страница 3: ...lass 63 getGlobal 86 load 87 LoadVars class 87 Log class 101 NetConnection class 102 protectObject 112 setAttributes 113 setInterval 115 SharedObject class 116 SOAPCall class 140 SOAPFault class 142 S...

Страница 4: ...4 Contents...

Страница 5: ...ipt server object model Server side ActionScript provides global methods and classes and exposes a rich object model for developing media applications You can also create classes properties and method...

Страница 6: ...tion on server side script files see Developing Media Applications NO TE For large scale applications you may need to use multiple server side script files You can use the Flash Media Server archive c...

Страница 7: ...rarchical naming system where a forward slash separates the elements in the hierarchy The first element specifies the application name The element following the application name specifies the applicat...

Страница 8: ...ion instance that lasts until the application instance is unloaded Client class The Client class lets you handle each user or client connection to a Flash Media Server application instance File class...

Страница 9: ...MLStreams class is a variation of the XMLSocket class It has all the same methods properties and events but it transmits and receives data in fragments Global function Description clearInterval Cancel...

Страница 10: ...llowDebug Application allowDebug appendChild XML appendChild attributes XML attributes autoCommit SharedObject autoCommit broadcastMsg Application broadcastMsg bufferTime Stream bufferTime call Client...

Страница 11: ...lt faultcode faultstring SOAPFault faultstring firstChild XML firstChild flush File flush SharedObject flush Stream flush gc Application gc get SharedObject get Stream get getBandwidthLimit Client get...

Страница 12: ...fied length File length Stream length list File list load load LoadVars load XML load loaded LoadVars loaded XML loaded localName XML localName lock SharedObject lock mark SharedObject mark mkdir File...

Страница 13: ...oad XML onLoad onLog Log onLog onResult SOAPCall onResult onStatus Application onStatus NetConnection onStatus SharedObject onStatus Stream onStatus onSync SharedObject onSync onXML XMLSocket onXML op...

Страница 14: ...e seek getGlobal send LoadVars send SharedObject send Stream send XML send XMLSocket send sendAndLoad LoadVars sendAndLoad XML sendAndLoad server Application server setAttributes setAttributes setBand...

Страница 15: ...ction to create the application object it is created automatically when an application is instantiated by the server Use the following syntax to call the methods properties and event handlers of the A...

Страница 16: ...s all stream objects associated with the current instance Application disconnect Disconnects a client from the server Application gc Invokes the garbage collector to reclaim any unused resources for t...

Страница 17: ...application instance Application server Read only the platform and version of the server Event handler Description Application onAppStart Invoked when the application is loaded by the server Applicati...

Страница 18: ...ceptConnection or application rejectConnection the last line in order of execution of the onConnect event handler should be either application acceptConnection or application rejectConnection Also any...

Страница 19: ...cription Method broadcasts a message to all connected clients This method is equivalent to looping through the Application clients array and calling Client call on each individual client but is more e...

Страница 20: ...include a slash as a delimiter between directories in the path The last element in the path can contain wildcard patterns for example a question mark and an asterisk or a shared object name The applic...

Страница 21: ...e application clearStreams streamPath Parameters streamPath A string that indicates the URI of a stream Returns A Boolean value of true if the stream at the specified path was deleted otherwise false...

Страница 22: ...all recorded FLV streams associated with the instance report clears the stream file report flv from the application instance directory presentations intro clears the recorded stream file intro flv fr...

Страница 23: ...ion The object is a custom object like an array but with only one property length Each element in the object is a reference to a Client object instance and you can use the length property to determine...

Страница 24: ...side scripting in Managing Flash Media Server Example Use the following sample ApplicationObject tag in the Application xml file for this Application config example Application JSEngine ApplicationObj...

Страница 25: ...er to terminate a client connection to the application When this method is called NetConnection onStatus is invoked on the client side with a status message of NetConnection Connection Closed The appl...

Страница 26: ...ges sent and received the number of dropped messages the number of clients connected to the application instance and the number of clients who have disconnected from the application instance Example T...

Страница 27: ...e application hostname Application name Availability Flash Communication Server MX 1 0 Usage application name Description Property read only contains the name of the Flash Media Server application ins...

Страница 28: ...vailability Flash Communication Server MX 1 0 Usage application onAppStop function info Parameters info An information object that explains why the application stopped running See Server Side Informat...

Страница 29: ...users that the application is exiting Example The following example defines a function to perform the shutdown operations on the application The function is then assigned to the event handler so that...

Страница 30: ...r reject the connection For example you can perform external authentication by making a NetConnection call in your application onConnect event handler to an application server and having the reply han...

Страница 31: ...dated You can use the application onConnect event in server side scripts to perform authentication All the information required for authentication should be sent to the server by the client as paramet...

Страница 32: ...N Insert code here to call methods that do authentication The following code accepts the connection by returning true return true The following example verifies that the user has sent the password XXX...

Страница 33: ...ability Flash Media Server with communication components only Usage application onConnectAccept function clientObj p1 pN Parameters clientObj A Client object the client connecting to the application p...

Страница 34: ...n nc new NetConnection nc connect rtmp test jlopes nc onStatus function info trace info code nc doSomething function trace doSomething called The following example is server side code you can include...

Страница 35: ...communication components are used that is when the components asc script is loaded into your server side script when NetConnection connect is called from the client side and a client fails to connect...

Страница 36: ...d components asc load components asc application onConnect function client username trace onConnect called gFrameworkFC getClientGlobals client username username if username hacker application rejectC...

Страница 37: ...y other users of this event This event handler is optional Example The following example uses an anonymous function and assigns it to the application onDisconnect event handler This code should be pla...

Страница 38: ...is invoked You can also define a function that gives users specific feedback about the type of error that occurred appInstance onStatus function infoObject trace An application error occurred Applica...

Страница 39: ...defined in the class Constructor functions should be used to initialize properties and methods they should not be used for executing server code Constructor functions are called automatically when me...

Страница 40: ...reen 0 this blue 0 Color prototype getRed function return this red Color prototype getGreen function return this green Color prototype getBlue function return this blue Color prototype setRed function...

Страница 41: ...parameter The server calls this method on the object specified by the proxyConnection parameter if proxyMethodName is different from the method specified by the methodName parameter Returns A value t...

Страница 42: ...type that is sent to the client explaining the reason for rejection The errObj object is available in client side scripts as the application property of the information object that is passed to the a...

Страница 43: ...This requirement exists only when you use components Example In the following example the client specified by client1 is rejected and provided with the error message contained in err message The messa...

Страница 44: ...m and the server version information Example The following example checks the server property against a string before executing the code in the if statement if application server Flash Media Server Wi...

Страница 45: ...nnected and Application onDisconnect is called for each client Calls made after calling shutdown may not execute Example In the following example the client specified by client1 is rejected and provid...

Страница 46: ...le creates a function named callback and passes it to the setInterval method which is called every 1000 milliseconds and outputs the message interval called The setInterval method returns a unique ide...

Страница 47: ...l from the client side script You can also call any methods you define in the server side script directly from the Client class instance in the server side script If all instances of the Client class...

Страница 48: ...lass return this writeAccess function Client_createUniqueID var ipStr this ip The ip property is already built in to the client class var uniqueID re123mn You would need to write code in the above lin...

Страница 49: ...h for the connection Property Description Client agent Read only the version and platform of the Flash client Client ip Read only the IP address of the Flash client Client protocol Read only the proto...

Страница 50: ...owing example checks the agent property against the string WIN and executes different code depending on whether they match This code is written in an onConnect function function onConnect newClient na...

Страница 51: ...rence to another ActionScript object These parameters are passed to the methodName parameter when the method executes on the Flash client If you use these optional parameters you must pass in some val...

Страница 52: ...on Server MX 1 0 Usage function clientCommand p1 pN Parameters p1 pN Optional parameters passed to the command message handler if the message contains parameters you defined These parameters are the A...

Страница 53: ...e sum method can also be called on the server side as shown here newClient sum The following example creates two functions that you can call from either a client side or server side script application...

Страница 54: ...indicates a server to client direction Returns An integer indicating bytes per second Description Method returns the maximum bandwidth that the client or the server can use for this connection Use the...

Страница 55: ...spond to a ping message Example The following example uses Client getStats to output a new client s statisitics application onConnect newClient stats newClient getStats trace Total bytes received stat...

Страница 56: ...ent ping Availability Flash Communication Server MX 1 0 Usage clientObject ping Description Method sends a ping message to the client and waits for a response If the client responds the method returns...

Страница 57: ...l rtmps RTMP over an SSL connection For more information about the HTTP tunneling feature in Flash Communication Server MX 1 0 see the NetConnection connect entry in the Client Side ActionScript Langu...

Страница 58: ...ssible for example myMedia mp3s Similarly any files or directories in the myMedia mp3s directory are also accessible and so on Clients with read access to a directory that contains streams can play st...

Страница 59: ...Availability Flash Communication Server MX 1 0 Usage Client __resolve function propName Parameters propName The name of an undefined property Returns The value of the undefined property which is speci...

Страница 60: ...iption Property read only a Boolean value that indicates whether an Internet connection is secure true or not false See also NetConnection connect Client setBandwidthLimit Availability Flash Communica...

Страница 61: ...to the onConnect function application onConnect function newClient serverToClient clientToServer newClient setBandwidthLimit serverToClient clientToServer application acceptConnection newClient Clien...

Страница 62: ...to directories containing application resources list directories in a string delimited by semicolons By default all clients have full write access and the writeAccess property is set to slash For exa...

Страница 63: ...on instance is running The server administrator can set up the sandbox for all applications within a virtual host and can provide additional control to individual applications if required The followin...

Страница 64: ...applications VirtualDirectory FileObject JSEngine This example specifies two additional directory mappings in addition to the default application directory Any path specified with videos xyz vacation...

Страница 65: ...string File readAll Reads the file and returns an array with an element for each line of the file File readByte Reads the next byte from the file and returns the numeric value of the next byte or 1 i...

Страница 66: ...ctory exists true or not false File isDirectory Read only a Boolean value indicating whether the file is a directory true or not false File isFile Read only a Boolean value indicating whether the file...

Страница 67: ...th is invalid the name property of the object is set to an empty string and no file operation can be performed Returns A File object if successful otherwise null Description Constructor to create an i...

Страница 68: ...whether a file can be read true or not false File canReplace Availability Flash Media Server 2 Usage fileObject canReplace Description Property read only a Boolean value indicating whether a file was...

Страница 69: ...ot false Description Method closes the file Returns false if the file is not open This method is called automatically on an open File object when the object is out of scope Example The following code...

Страница 70: ...s and the method returns false Returns A Boolean value indicating whether the file as copied successfully true or not false Description Method copies a file to a different location or copies it to the...

Страница 71: ...end of file true or not false If the file is closed the method returns true Example The following while statement lets you insert code that executes until the file pointer is at the end of a file whil...

Страница 72: ...f statement lets you insert code that executes if myFileObj flushes successfully if myFileObj flush Do something here File isDirectory Availability Flash Media Server 2 Usage fileObject isDirectory De...

Страница 73: ...leObject isFile Description Property read only a Boolean value indicating whether a file is a data file true or not false File isOpen Availability Flash Media Server 2 Usage fileObject isOpen Descript...

Страница 74: ...Object list filter Parameters filter A Function object that determines the files in the returned array If the function returns true when a file s name is passed to it as a parameter the file is added...

Страница 75: ...irectory Example The following example creates a logs directory in the myFileObject instance if myFileObject mkdir logs Do something if a logs directory is created successfully File mode Availability...

Страница 76: ...y Opens the file for binary access utf8 Opens the file for UTF 8 access mode A string indicating the mode in which to open the file The following modes are valid and can be combined modes are case sen...

Страница 77: ...tes when a text file is opened in read mode if myFileObject open text read Do something here File position Availability Flash Media Server 2 Usage fileObject position Description Property the current...

Страница 78: ...e and a byte if myFileObject open text read strVal myFileObject read 100 strLine myFileObject readln strChar myFileObject readByte See also File readAll File readByte File readln File readAll Availabi...

Страница 79: ...fails if file is not opened in binary mode See also File read File readAll File readln File readln Availability Flash Media Server 2 Usage fileObject readln Parameters None Returns A string Descripti...

Страница 80: ...ry was removed successfully true or not false Description Method removes the file or directory specified to by the File object The method returns false if the file is open the path points to a root fo...

Страница 81: ...se Description Method moves or renames a file The operation fails if the file is open or the directory points to the root directory Example The following code lets you execute code when myFileObject i...

Страница 82: ...e seek call is successful the code in the if statement runs if fileObj seek 10 1 Do something here File toString Availability Flash Media Server 2 Usage fileObject toString Parameters None Returns A s...

Страница 83: ...am0 param1 paramN Parameters param0 param1 paramN Parameters to write to the file Returns A Boolean value indicating whether the write was successful true or not false Description Method writes data t...

Страница 84: ...Method takes an array as a parameter and calls the File writeln method on each element in the array The file contents are buffered internally The File flush method writes the buffer to the file on dis...

Страница 85: ...param0 param1 paramN Parameters param0 param1 paramN Strings to write to the file Returns A Boolean value indicating whether the write was successful true or not false Description Method writes data...

Страница 86: ...two script execution modes secure and normal In secure mode only the secure asc file if it exists is loaded and evaluated no other application scripts are loaded Also the global getGlobal and protectO...

Страница 87: ...d is useful for loading ActionScript libraries Example The following example loads the myLoadedFile as file load myLoadedFile as LoadVars class Availability Flash Media Server 2 The LoadVars class let...

Страница 88: ...POST actions LoadVars decode Converts the query string to properties of the specified LoadVars object LoadVars getBytesLoaded Returns the number of bytes loaded from the last or current LoadVars load...

Страница 89: ...scription LoadVars contentType The MIME type sent to the server when you call the LoadVars send or LoadVars sendAndLoad method LoadVars loaded A Boolean value that indicates whether a LoadVars load or...

Страница 90: ...er name each successive value will replace the value set in the previous call The following standard HTTP headers cannot be added or changed with this method Accept Ranges Age Allow Allowed Connection...

Страница 91: ...rs contentType Description Property the MIME type that is sent to the server when you call the LoadVars send or LoadVars sendAndLoad method The default is application x www urlform encoded Example The...

Страница 92: ...e three variables Create a new LoadVars object var my_lv new LoadVars Convert the variable string to properties my_lv decode name Mort score 250000 trace my_lv toString Iterate over properties in my_l...

Страница 93: ...s initiated but the server did not transmit an HTTP content length Description Method returns the total number of bytes loaded into an object during all LoadVars load or LoadVars sendAndLoad method ca...

Страница 94: ...aded variables are overwritten The downloaded data must be in the MIME content type and be application x www urlform encoded The LoadVars load method call is asynchronous Example The following code de...

Страница 95: ...ded from the server or when an error occurs while data is downloading from a server This handler is invoked before the data is parsed and can be used to call a custom parsing routine instead of the on...

Страница 96: ...he requested URI HTTP status codes can be found in sections 10 4 and 10 5 of the HTTP specification Description Event handler invoked when Flash Media Server receives an HTTP status code from the serv...

Страница 97: ...Vars onHTTPStatus function httpStatus this httpStatus httpStatus if httpStatus 100 this httpStatusType flashError else if httpStatus 200 this httpStatusType informational else if httpStatus 300 this h...

Страница 98: ...ver the success parameter is false If the success parameter is true the loadVarsObject is populated with variables downloaded by the LoadVars load or LoadVars sendAndLoad operation and these variables...

Страница 99: ...object to the specified URL All enumerable variables in the myLoadVars object are concatenated into a string that is posted to the URL using the HTTP POST method The MIME content type sent in the HTT...

Страница 100: ...dVars load See also LoadVars send LoadVars toString Availability Flash Media Server 2 Usage myLoadVars toString Parameters None Returns A string Description Method returns a string containing all enum...

Страница 101: ...of the following if not set explicitly the level defaults to Log BRIEF Log BRIEF Primary life cycle event and error notifications are received Log VERBOSE All life cycle event and error notifications...

Страница 102: ...application server another Flash Media Server or another Flash Media Server application instance on the same server You can use NetConnection objects to create powerful applications for example you ca...

Страница 103: ...dHeader Adds a context header NetConnection call Invokes a method or operation on a remote server NetConnection close Closes a server connection NetConnection connect Connects to an application server...

Страница 104: ...ActionScript object Returns Nothing Description Method adds a context header to the AMF packet structure This header is sent with every future AMF packet If you call NetConnection addHeader using the...

Страница 105: ...reference to another ActionScript object These parameters are passed to the methodName specified above when the method is executed on the remote application server Returns For RTMP connections return...

Страница 106: ...This allows Flash Media Server to connect to an application server and then invoke the quote method The Java adaptor dispatches the call by using the identifier to the left of the dot as the class nam...

Страница 107: ...lue of true for success false otherwise For AMF connections to application servers true is always returned Description Method connects to an application server or another Flash Media Server The host U...

Страница 108: ...te Similarly a regular RTMP connection to port 443 fails because the server tries to perform an SSL handshake that the client cannot complete You can determine whether a connection to the server is ov...

Страница 109: ...et connection Escaping URIs is especially important when creating a debugging connection because there are special characters in the debugging property that must be appended to the URI Use the followi...

Страница 110: ...erver It s a good idea to check this property value in an onStatus callback function This property is always true for AMF connections to application servers Example The following example uses NetConne...

Страница 111: ...event handler to check for connectivity Example The following example defines a function for the onStatus handler that outputs messages to indicate whether the NetConnection was successful nc new Net...

Страница 112: ...ectObject functions are only available in secure mode These are very powerful because they provide complete access to the script execution environment and let you create system objects Once the secure...

Страница 113: ...he global object var global getGlobal Now protect our sysobj and make it available as system globally Also set its attributes so that it is read only and not deletable global system protectObject syso...

Страница 114: ...akes a property permanent nondeletable if true or deletable if false a null value leaves this attribute unchanged Any attempt to delete a permanent property by calling delete obj prop is ignored Descr...

Страница 115: ...r method at a specified time interval until the clearInterval method is called This method allows a server side script to run a generic routine The setInterval method returns a unique ID that you can...

Страница 116: ...objects as real time data transfer devices The following list describes common ways to use shared objects in server side ActionScript Storing and sharing data on a server A shared object can store da...

Страница 117: ...application s state Every RSO is identified by a unique name and contains a list of name value pairs called properties like any other ActionScript object A name must be a unique string and a value ca...

Страница 118: ...ect instances that are marked dirty SharedObject flush Saves the current state of a persistent shared object SharedObject get Static creates a shared object or returns a reference to an existing share...

Страница 119: ...persistent shared objects to be stored true or not false SharedObject isDirty A Boolean value indicating whether the persistent SharedObject has been modified since the last time it was stored true o...

Страница 120: ...O clear Parameters None Returns Returns true if successful false otherwise Description Method deletes all the properties of a single shared object and sends a clear event to all clients that subscribe...

Страница 121: ...proxy a shared object any longer Example In the following example mySO is attached as a reference to shared object foo When you call mySO close you detach the reference mySO from the shared object foo...

Страница 122: ...dObject commit SharedObject flush Availability Flash Communication Server MX 1 0 Usage mySO flush Parameters None Returns A Boolean value of true if successful false otherwise Description Method saves...

Страница 123: ...onnection object that is used as the netConnection parameter does not need to be connected when you call SharedObject get The server connects to the remote shared object when the NetConnection state c...

Страница 124: ...m connected to disconnected the proxied shared object is set to idle and any messages received from subscribers are discarded The NetConnection onStatus handler is called when a connection is lost You...

Страница 125: ...e master and gives the client a reference to this shared object The following code is in the main asc file application appStart function nc new NetConnection nc connect rtmp master_server master_insta...

Страница 126: ...y of strings that contain all the property names of a shared object Description Method enumerates all the property names for a given shared object Example The following example calls getPropertyNames...

Страница 127: ...andler onBroadcastMsg in the Usage example above the handler is invoked when a shared object receives a broadcast message with the same name You must define a function object and assign it to the even...

Страница 128: ...stores shared objects with an isDirty property that is true This property is always false for non persistent shared objects Example The following example saves the so shared object if it has been chan...

Страница 129: ...aredObject lock method on proxied shared objects Example The following example locks the myShared shared object executes the code that is to be inserted and then unlocks the object var myShared Shared...

Страница 130: ...ht not be sent in the same order as they were in the code Use the mark method when you want to execute code after all the properties in a set have been updated If an application calls the lock method...

Страница 131: ...ow x onActChange function str Shared Object has been updated can look at the account property now SharedObject name Availability Flash Communication Server MX 1 0 Usage mySO name Description Property...

Страница 132: ...erties of a shared object that have changed since the last time the onSync handler was called The notifications for proxied shared objects are different than for shared objects that are owned by the l...

Страница 133: ...red object or if another subscriber deletes a property clear All the properties of a shared object are deleted This can happen when the server s shared object is out of sync with the master shared obj...

Страница 134: ...an array of objects containing information about successfully of unsuccessfully changed properties from the last time onSync was called so onSync function list for var i 0 i list length i switch list...

Страница 135: ...rver MX 1 0 Usage mySO resyncDepth Description Property an integer that indicates when the deleted properties of a shared object should be permanently deleted You can use this property in a server sid...

Страница 136: ...O if the revision number difference is greater than 10 mySo SharedObject get foo mySo resyncDepth 10 SharedObject send Availability Flash Communication Server MX 1 0 Usage mySO send methodName p1 pN P...

Страница 137: ...nnect connection x doSomething function str Process the str object SharedObject setProperty Availability Flash Communication Server MX 1 0 Usage mySO setProperty name value Parameters name The name of...

Страница 138: ...thod is called The SharedObject onSync handler on the client side is invoked when the local copy of the shared object is updated Example The following example uses the SharedObject setProperty method...

Страница 139: ...k count 0 or greater if successful 1 otherwise For proxied shared objects this method always returns 1 Description Method unlocks a shared object instance It causes the script to relinquish exclusive...

Страница 140: ...ility Flash Media Server 2 The SOAPCall class is the object type that is returned from all web service calls These objects are most typically constructed automatically when a WSDL is parsed and a stub...

Страница 141: ...on Event handler invoked when a method has failed and returned an error SOAPCall onResult Availability Flash Media Server 2 Usage mySOAPCall onResult result Parameters result The decoded ActionScript...

Страница 142: ...class Availability Flash Media Server 2 The SOAPFault class is the object type of the error object returned to WebService onFault and SOAPCall onFault functions This object is returned as the result...

Страница 143: ...e mySOAPFault faultactor Description Property a string indicating the source of the fault This property is optional if an intermediary is not involved SOAPFault faultcode Availability Flash Media Serv...

Страница 144: ...event stockService onLoad function wsdl wsdlField text wsdl If the wsdl fails to load the onFault event is fired stockService onFault function fault wsdlField text fault faultstring Stream class Avail...

Страница 145: ...lass Property read only Description Stream bufferTime Indicates how long to buffer messages before a stream is played Stream name The unique name of a live stream Stream syncWrite A Boolean value that...

Страница 146: ...ly To set this property use Stream setBuffertime A message is data that is sent back and forth between Flash Media Server and Flash Player The data is divided into small packets messages and each mess...

Страница 147: ...successfully if info code NetStream Clear Failed trace Failed to clear stream s clear See also Stream get Stream flush Availability Flash Media Server 2 Usage myStream flush Parameters None Returns A...

Страница 148: ...plication myStream send test hello world application myStream flush Stream get Availability Flash Communication Server MX 1 0 Usage myStream get name Parameters name The name of the stream instance to...

Страница 149: ...not associated with a client but connects to a stream on the server you may need to specify a virtual key to identify the correct stream For more information about keys see Client virtualKey This para...

Страница 150: ...ssociated with it function getStreamName myStream return myStream name Stream onStatus Availability Flash Communication Server MX 1 0 Usage myStream onStatus function infoObject Parameters infoObject...

Страница 151: ...eloping Media Applications startTime The start time of the stream playback in seconds If no value is specified it is set to 2 If startTime is 2 the server tries to play a live stream with the name spe...

Страница 152: ...ich the messages were originally recorded the default behavior For more information on Flash Media Server logging see TechNote 16464 on the Macromedia Flash Media Server Support Center at www macromed...

Страница 153: ...r calls a play method on the same stream In general if any recorded streams are included in a server playlist you cannot play the server stream as a live stream If you require a value to begin a strea...

Страница 154: ...is used as a hub to switch between live streams and recorded streams Set up the server stream application myStream Stream get foo if application myStream This server stream plays Live1 Record1 and Liv...

Страница 155: ...1 In the following example data messages in the recorded stream file log flv are returned all at once rather than at the intervals which they were originally recorded application myStream Stream get d...

Страница 156: ...name of a method relative to the subscribing Stream object For example if handlerName is doSomething the doSomething method at the stream level is invoked with all the p1 pN parameters Unlike the met...

Страница 157: ...MX 1 0 Usage myStream setBufferTime Description Method increases the message queue length When you play a stream from a remote server the Stream setBufferTime method sends a message to the remote ser...

Страница 158: ...Path method to dynamically serve Flash Player 8 clients a better version of a video stream When Flash Player requests a stream from Flash Media Server the Flash Player version determines the server si...

Страница 159: ...streams To set up several virtual directories for different Flash Player versions use the same virtual path with different physical directories for each Streams tag as shown in the following example...

Страница 160: ...e them in different physical directories and use the VirtualDirectory section and VirtualKeys section of the vhost xml file to direct clients to the appropriate stream Because the Stream size method i...

Страница 161: ...shed to the FLV file immediately It is highly recommended that user should only set syncWrite to true in a stream that contains only data Synchronization problems might occur when syncWrite is set to...

Страница 162: ...ting a file The trace function is similar to the alert function in JavaScript WebService class Availability Flash Media Server 2 Description You can use the WebService class to create and access a WSD...

Страница 163: ...llback callback stockService doCompanyInfo anyuser anypassword MACR NOTE callback is undefined if the service itself is not created and service onFault is also invoked 7 Handle either the output or th...

Страница 164: ...hods Example The following example prepares the WSDL location and passes it to the WebService constructor to create a new WebService object stockService var wsdlURI http www flash db com services ws c...

Страница 165: ...tockService onLoad function wsdl wsdlField text wsdl If the wsdl fails to load the onFault event is fired stockService onFault function fault wsdlField text fault faultstring WebService onLoad Availab...

Страница 166: ...XML class lets you load parse send build and manipulate XML document trees You must use the constructor new XML to create an XML object before calling any method of the XML class An XML document is r...

Страница 167: ...the specified XML object has loaded XML localName Read only the local name portion of the XML node s name XML namespaceURI Read only if the XML node has a prefix namespaceURI is the value of the xmln...

Страница 168: ...turns the namespace URI that is associated with the specified prefix for the node XML getPrefixForNamespace Returns the prefix that is associated with the specified namespace URI for the node XML hasC...

Страница 169: ...from the server or when an error occurs downloading XML text from a server XML onHTTPStatus Invoked when Flash Media Server receives an HTTP status code from the server This handler lets you capture...

Страница 170: ...with the resulting XML document tree var other_xml new XML state name California city San Francisco city state See also XML createElement XML createTextNode XML addRequestHeader Availability Flash Me...

Страница 171: ...y Authenticate Proxy Authorization Public Range Retry After Server TE Trailer Transfer Encoding Upgrade URI Vary Via Warning and WWW Authenticate Example The following example adds a custom HTTP heade...

Страница 172: ...nt named doc1 3 Shows how to move a node using the appendChild method by moving the root node from doc1 to doc2 4 Clones the root node from doc2 and appends it to doc1 5 Creates a new node and appends...

Страница 173: ...t attribute s value by using the color as the key index as shown in the following code var myColor doc firstChild attributes color Example The following example shows the XML attribute names Create a...

Страница 174: ...ample The following example shows how to use the XML childNodes property to return an array of child nodes Create a new XML document var doc new XML Create a root node var rootNode doc createElement r...

Страница 175: ...rns a new XMLNode object of the same type name management console value and attributes as the specified XML object If deep is set to true all child nodes are recursively cloned resulting in an exact c...

Страница 176: ...odes as children of rootNode rootNode appendChild oldest rootNode appendChild middle rootNode appendChild youngest Create a copy of the middle node using cloneNode var middle2 middle cloneNode false I...

Страница 177: ...content type used for most HTML forms Example The following example creates a new XML document and checks its default content type Create a new XML document var doc new XML Trace the default content...

Страница 178: ...eTextNode method are the constructor methods for creating nodes for an XML object Example The following example creates three XMLNode objects using the createElement method Create an XML document var...

Страница 179: ...nodes for an XML object Example The following example creates two XML text nodes using the createTextNode method and places them into existing XML nodes Create an XML document var doc new XML Create...

Страница 180: ...n XMLNode object The ActionScript XML parser is not a validating parser The DOCTYPE declaration is read by the parser and stored in the XML docTypeDecl property but no DTD validation is performed If n...

Страница 181: ...owing example shows how to use XML firstChild to loop through a node s child nodes Create a new XML document var doc new XML Create a root node var rootNode doc createElement rootNode Create three chi...

Страница 182: ...loaded Description Method returns the number of bytes loaded streamed for the XML document You can compare the value of getBytesLoaded with the value of getBytesTotal to determine what percentage of...

Страница 183: ...he namespace that is associated with the specified prefix Description Method returns the namespace URI that is associated with the specified prefix for the node To determine the URI getPrefixForNamesp...

Страница 184: ...h Media Server 2 Usage my_xml getPrefixForNamespace nsURI Parameters nsURI A String the namespace URI for which the method returns the associated prefix Returns A String the prefix associated with the...

Страница 185: ...o defines a namespace URI http www example com child but does not assign it to a prefix Calling this method on the defined but unassigned namespace URI returns an empty string function createXML var s...

Страница 186: ...L packet If the root node has child nodes the code loops over each child node to display the name and value of the node var my_xml new XML login username hank username password rudolph password login...

Страница 187: ...e 1 You can set the ignoreWhite property for individual XML objects as shown in the following code my_xml ignoreWhite true Usage 2 You can set the default ignoreWhite property for XML objects as shown...

Страница 188: ...o the flooring object flooring load flooring xml output line breaks added for clarity house kitchen ceramic tile kitchen bathroom linoleum bathroom foyer house If you change the setting of flooring ig...

Страница 189: ...llowing example is an excerpt from the XML cloneNode example Create a copy of the middle node using cloneNode var middle2 middle cloneNode false Insert the clone node into rootNode between the middle...

Страница 190: ...oc createElement oldest var middle doc createElement middle var youngest doc createElement youngest Add the rootNode as the root of the XML document tree doc appendChild rootNode Add each of the child...

Страница 191: ...lastChild aNode null aNode aNode previousSibling trace aNode output youngest middle oldest See also XML appendChild XML insertBefore XML removeNode XML load Availability Flash Media Server 2 Usage my...

Страница 192: ...object previously contained any XML trees they are discarded You can define a custom function that executes when the onLoad event handler of the XML object is invoked Example The following simple exam...

Страница 193: ...true my_xml onLoad function success trace success success trace loaded my_xml loaded trace status my_xml status my_xml load http www flash mx com mm problems products xml Information writes to the lo...

Страница 194: ...ame Example This example uses a SWF file and an XML file located in the same directory The XML file named SoapSample xml contains the following xml version 1 0 soap Envelope xmlns soap http www w3 org...

Страница 195: ...efault namespace the value of the namespaceURI property is the value of the default namespace If there is no default namespace the namespaceURI property for that node is an empty string You can use th...

Страница 196: ...org 2001 12 soap envelope var soapBodyNode xmlDoc childNodes 0 childNodes 0 trace soap Envelope namespaceURI soapBodyNode namespaceURI Output http www w3 org 2001 12 soap envelope The following examp...

Страница 197: ...that references the next sibling in the parent node s child list This property is null if the node does not have a next sibling node This property cannot be used to manipulate child nodes use the app...

Страница 198: ...g If the XML object is a text node nodeType 3 nodeName is null Example The following example creates an element node and a text node and checks the node name of each Create an XML document var doc new...

Страница 199: ...extSibling if aNode nodeType 1 trace aNode nodeName t aNode firstChild nodeValue The following node names appear username hank password rudolph See also XML nodeType XML nodeType Availability Flash Me...

Страница 200: ...L tree doc appendChild myNode Create an XML text node using createTextNode var myTextNode doc createTextNode textNode Place the new node into the XML tree myNode appendChild myTextNode trace myNode no...

Страница 201: ...and read only Example The following example creates an element node and a text node and checks the node value of each Create an XML document var doc new XML Create an XML node using createElement var...

Страница 202: ...var i 0 i my_xml firstChild childNodes length i trace t my_xml firstChild childNodes i firstChild nodeValue The following information is written to the log file using firstChild morton good evil using...

Страница 203: ...XML onData event handler with custom behavior but XML onLoad is not called unless you call it in your XML onData implementation Example The following example shows what the XML onData event handler lo...

Страница 204: ...communicate with the server the default value of 0 is passed to your ActionScript code Example The following example shows how to use onHTTPStatus to help with debugging The example collects HTTP sta...

Страница 205: ...lue that is true if the XML object successfully loads with a XML load or XML sendAndLoad operation false otherwise Returns Nothing Description Event handler invoked by Flash Media Server when an XML d...

Страница 206: ...Reply_xml onLoad function success if success if myLoginReply_xml firstChild nodeName packet myLoginReply_xml firstChild attributes success true gotoAndStop loggedIn else gotoAndStop loginFailed else g...

Страница 207: ...de parentNode nodeName trace contents of the parent node are n targetNode parentNode output line breaks added for clarity the parent node of username is login contents of the parent node are login use...

Страница 208: ...tr trace my1_xml firstChild attributes name output California Defining the XML source using the XML parseXML method var my2_xml new XML my2_xml parseXML xml_str trace my2_xml firstChild attributes nam...

Страница 209: ...noreWhite true xmlDoc load SoapSample xml xmlDoc onLoad function success var tempNode xmlDoc childNodes 0 childNodes 0 childNodes 0 trace w GetTemperature prefix tempNode prefix Output w var soapEnvNo...

Страница 210: ...rootNode lastChild aNode null aNode aNode previousSibling trace aNode See also XML appendChild XML insertBefore XML removeNode XML removeNode Availability Flash Media Server 2 Usage my_xml removeNode...

Страница 211: ...California city San Francisco city state after XML removeNode state name California XML send Availability Flash Media Server 2 Usage my_xml send url fileObj Parameters url A string the destination URL...

Страница 212: ...com mm highscore cfm myFile See also XML sendAndLoad XML sendAndLoad Media Server 2 Usage my_xml sendAndLoad url targetXMLobject Parameters url A string the destination URL for the specified XML obje...

Страница 213: ...ad method transmits an XML element that contains the user s name and password and uses an onLoad handler to process the reply from the server var login_str login username username_txt text password pa...

Страница 214: ...omment was not properly terminated 6 An XML element was malformed 7 Out of memory 8 An attribute value was not properly terminated 9 A start tag was not matched with an end tag 10 An end tag was encou...

Страница 215: ...ut of memory break case 8 errorMessage An attribute value was not properly terminated break case 9 errorMessage A start tag was not matched with an end tag break case 10 errorMessage An end tag was en...

Страница 216: ...claration stored in the XML xmlDecl property followed by the document s DOCTYPE declaration stored in the XML docTypeDecl property followed by the text representation of all XML nodes in the object Th...

Страница 217: ...e property is set to undefined XML The XML toString method outputs the contents of the XML xmlDecl property before any other text in the XML object If the XML xmlDecl property contains the undefined t...

Страница 218: ...tion Each XML message is a complete XML document terminated by a zero 0 byte An unlimited number of XML messages can be sent and received over a single XMLSocket connection The following restriction a...

Страница 219: ...or a new XMLStreams object stream The XMLSocket and XMLStreams objects are not initially connected to any server You must call XMLSocket connect to connect the object to a server Method Description X...

Страница 220: ...XMLStreams object var stream new XMLSocket stream XMLSocket close Availability Flash Media Server 2 Usage myXMLSocket close Parameters None Returns Nothing Description Method closes the connection spe...

Страница 221: ...ng on whether a connection is successfully established If you don t know the port number of the Internet host computer contact your network administrator If you specify null for the host parameter the...

Страница 222: ...ee also XMLSocket onConnect XMLSocket onClose Availability Flash Media Server 2 Usage myXMLSocket onClose function Parameters None Returns Nothing Description Event handler invoked only when an open c...

Страница 223: ...e indicating whether a socket connection is successfully established true or false Returns Nothing Description Event handler invoked by Flash Media Server when a connection request initiated through X...

Страница 224: ...y the server Returns Nothing Description Event handler invoked when a message has been downloaded from the server terminated by a zero 0 byte You can override XMLSocket onData to intercept the data se...

Страница 225: ...nlimited number of XML documents between the client and the server Each document is terminated with a zero 0 byte When Flash Media Server receives the zero byte it parses all the XML received since th...

Страница 226: ...followed by a zero 0 byte If object is an XML object the string is the XML textual representation of the XML object The send operation is asynchronous it returns immediately but the data may be trans...

Страница 227: ...stream tag contains fragments of XML content and concludes with a stream stream closing tag The onData event is invoked and returns complete XML tags whenever it receives them The stream stream tag cl...

Страница 228: ...228 Server Side ActionScript Language Reference...

Страница 229: ...u pass to the function You need to place this code in the main asc file only once function showStatusForClass for var i 0 i arguments length i arguments i prototype onStatus function infoObj trace inf...

Страница 230: ...re set filename name of the offending ASC file lineno line number where the error occurred linebuf source code of the offending line Application Resource LowMemory Warning The ActionScript engine is l...

Страница 231: ...shut down NetConnection call BadVersion Error The URI specified in the NetConnection connect method did not specify rtmp as the protocol rtmp must be specified when connecting to Flash Communication...

Страница 232: ...ss Status An attempt to unpublish was successful NetStream Record Start Status Recording was started NetStream Record NoAccess Error An attempt was made to record a read only stream NetStream Record S...

Страница 233: ...s useful for multiple plays The details property shows the name of the stream when switching from one element in the playlist to the next element By default outgoing messages are monitored at 5 second...

Страница 234: ...234 Server Side Information Objects...

Результаты поиска

Содержание FLASH MEDIA SERVER 2-SERVER-SIDE ACTIONSCRIPT...

Отзывы:

Похожие инструкции для FLASH MEDIA SERVER 2-SERVER-SIDE ACTIONSCRIPT...

Бренды по названию

Популярные бренды

MACROMEDIA FLASH MEDIA SERVER 2-SERVER-SIDE ACTIONSCRIPT..., Справочник

Результаты поиска

Содержание FLASH MEDIA SERVER 2-SERVER-SIDE ACTIONSCRIPT...

Отзывы:

Похожие инструкции для FLASH MEDIA SERVER 2-SERVER-SIDE ACTIONSCRIPT...

Бренды по названию

Популярные бренды