Home » Adobe Manuals » Computer Software » Adobe 65029121 » Manual Viewer

Adobe 65029121 Developer's Guide - Page 17

Creating clients for streaming services

UPC - 883919169231

Add to My Manuals
Save this manual to your list of manuals

Page 17 highlights

ADOBE FLASH MEDIA SERVER 14 Developer Guide 3 Open the Application.xml file in the RootInstall/applications/vod2 folder and add VOD2_DIR to the virtual directory entry list: /;${VOD2_DIR}. 4 Restart Adobe Flash Media Server. 5 Place recorded media files into the folder you specified in the fms.ini file (in this example, C:\Program Files\Adobe\Flash Media Server 3\applications\vod2\media). The media files are now accessible from the URL rtmp://flashmediaserver/vod2/filename. Note: You do not have to specify the media subdirectory in the URL; the media directory is specified in the path you set in the fms.ini file. Disable vod services ❖ Move any vod service folders you want to disable out of the applications folder. Creating clients for streaming services Creating client applications Start with the provided sample client code (RootInstall/samples/applications/live and RootInstall/samples/applications/vod) and modify it as desired. Clients for the vod and live services can use any Flash Player features except the following: • Recording live streams (NetStream.publish("streamName", "record")). • Remote shared objects (SharedObject.getRemote()). Using the FLVPlayback component You can use the Flash 8 FLVPlayback component and the Flash CS3 FLVPlayback component as clients for the vod and live services. Set the contentPath parameter to the URL of the stream and, if you're connecting to the live service, set the isLive parameter to true. Connecting to a streaming service The streaming services expect the incoming URI to be in the following format: rtmp://hostName/serviceName/instanceName/[formatType:]fileOrStreamName hostName The Flash Media Server domain name. serviceName Either live or vod. instanceName If the client is connecting to the default instance, you can either omit the instance name or use _definst_. If the client is connecting to an instance you have created, such as room1, use that name. formatType One of the supported file formats, flv:, mp3: or mp4:. The default format if unspecified is flv:. fileOrStreamName Either a file name (for example, my_video.mp4) or a pathname (for example, subdir/subdir2/my_video.mp4). If the file is an FLV or MP3 file, you do not need to specify the file format. If the file is an MP4 file, you must specify the file format, for example, rtmp://www.examplemediaserver.com/vod/ClassicFilms/mp4:AnOldMovie.mp4.

Section	Page
Contents	3
Chapter 1: Getting started	4
Overview	4
Client-server architecture	4
Parts of a media application	5
Stream formats	5
Set up a development environment	6
Install the server	6
Install Flash	6
Install Flex	6
Hello World application	7
Overview	7
Create the user interface	7
Write the client-side script	8
Write the server-side script	9
Compile and run the application	9
Create an application	9
Write the client-side code	9
Writing server-side code	10
Test an application	11
Test and debug a server-side script	11
Test and debug a client-side script	13
Deploy an application	13
Copy server-side files and assets to Flash Media Server	13
Copy client-side files to a web server	14
Chapter 2: Streaming services	15
Using the live service	15
About the live service	15
Test the live service	15
Modify the live service	16
Disable live services	16
Using the vod service	16
About the vod service	16
Test the vod service	16
Modify the vod service	16
Disable vod services	17
Creating clients for streaming services	17
Creating client applications	17
Using the FLVPlayback component	17
Connecting to a streaming service	17
Allow connections from specific domains	18
Chapter 3: Developing media applications	19
Connecting to the server	19
The NetConnection class	19
The application URI	19
Mapping URIs to local and network drives	20
Hello Server application	21
Managing connections	24
Connection status codes	24
Managing connections in server-side code	24
Managing connections sample application	25
Recorded streams	26
Playing recorded streams	26
Capturing video snapshots	27
Handling metadata in the stream	27
Video player example	27
Handling errors	31
About error handling	31
Handle a failed connection	32
Handle a stream not found	32
Playlists	33
About playlists	33
Create a client-side playlist	33
Multiple bit rate switching	34
About multiple bit rate switching	34
Deliver streams based on Flash Player version	34
Detecting bandwidth	35
About detecting bandwidth	35
ActionScript 3.0 native bandwidth detection	35
ActionScript 2.0 native bandwidth detection	37
Script-based bandwidth detection	38
Detecting stream length	39
About detecting stream length	39
Virtual stream names	39
Get the length of a stream	39
Buffering streams dynamically	42
About buffering streams	42
Handle buffer events	42
Chapter 4: Developing live video applications	44
Capturing and streaming live audio and video	44
About publishing streams and subscribing to streams	44
LiveStreams example	44
Record live video	46
Add metadata to a live stream	47
About metadata	47
Metadata properties for live streams	47
Metadata properties for recorded live streams	48
Add metadata to live video	49
Clear metadata from live video	50
Retrieve metadata from live video	51
Publish from server to server	51
About multipoint publishing	51
Multipoint publishing	52
Chapter 5: Developing social media applications	54
Shared objects	54
About shared objects	54
Remote shared objects	55
SharedBall example	56
Broadcast messages to many users	58
Allow and deny access to assets	58
About access control	58
Implement dynamic access control	58
Authenticate clients	59
Use properties of the Client object	59
Use a unique key	60
Use an Access plug-in	60
Use Flash Player version	61
Verify connecting SWF files	61
Allow and deny connections from specific domains	61
Authenticate users	63
Authenticate using an external resource	63
Authenticate using a token	64
Index	65
A	65
access control 55	65
ActivityEvent class 41	65
Administration Console 8	65
Adobe Flash CS3 Professional 3	65
Adobe Flash Media Development Server 1	65
Adobe Flash Media Interactive Server 1	65
Adobe Flash Media Server	65
installing 3	65
starting 3	65
Adobe Flash Media Streaming Server 1	65
Adobe Flash Player 3	65
Adobe Flex 3	65
Adobe Real-Time Messaging Protocol (RTMP) 1	65
allowedHTMLdomains.txt file 15	65
allowedSWFdomains.txt file 15	65
Application class 8	65
application.onConnect event 22	65
application.onDisconnect event 22	65
application.onPublish event 41	65
application.onUnpublish event 41	65
applications	65
client-side code 6	65
connection URI 16	65
debugging 10	65
double-byte 8	65
HelloServer sample 18	65
live service 12	65
registering with the server 10	65
server-side code 7	65
vod service 13	65
authentication	65
clients 56	65
domains 58	65
Flash Player version 58	65
B	65
bandwidth, detecting 32, 35	65
buffering 39	65
C	65
Camera class 41	65
checkBandwidth function 32	65
Client class 8	65
ip property 56	65
readAccess property 55	65
writeAccess property 55	65
clients, authenticating 56	65
client-side code	65
about 6	65
debugging 10	65
D	65
debugging	65
Administration Console sessions 9	65
client-side code 10	65
server-side code 8	65
domains	65
allowing connections from 15, 58	65
double-byte applications 8	65
E	65
events	65
netStatus 29	65
onMetaData 28	65
onPlayStatus 28	65
F	65
Flash Archive utility (FAR) 11	65
FLVCheck utility 28	65
H	65
HelloServer application 18	65
HelloWorld application 4	65
L	65
live service 12	65
live video	65
metadata 44, 48	65
publishing 41	65
recording 43	65
streaming 41	65
subscribing 41	65
log file 9	65
M	65
metadata	65
about 44	65
adding to live streams 44	65
properties 45	65
retrieving 48	65
Microphone class 41	65
multipoint publishing 48	65
N	65
NetConnection class	65
about 16	65
client property 33	65
status codes 22, 29	65
netStatus events 29	65
NetStream class	65
pause method 39	65
play method 23	65
O	65
onBWCheck function 32	65
onBWDone function 32	65
onMetaData event handler 28	65
onPlayStatus event handler 28	65
P	65
publishing	65
live video 41	65
multipoint 48	65
R	65
RTMP 1	65
S	65
Server-Side ActionScript	65
about 7	65
handling connections 21	65
packaging 11	65
trace statement 9	65
shared objects	65
about 51	65
broadcasting messages 55	65
local 51	65
persistent 51	65
remote 14, 51	66
temporary 51	66
SharedBall example 53	66
Stream class 36	66
streaming services 12	66
streams	66
buffering 39	66
formats 2	66
pausing 39	66
playing 23	66
virtual naming 36	66
SWF files	66
publishing 11	66
verifying authenticity of 58	66
U	66
URI, format for connecting to server 16	66
UTF-8 encoding 8	66
V	66
Vhost.xml file 36	66

Match case Limit results 1 per page

ADOBE FLASH MEDIA SERVER

Developer Guide

Open the Application.xml file in the

RootInstall

/applications/vod2 folder and add

VOD2_DIR

to the virtual

directory entry list:

Restart Adobe Flash Media Server.

Place recorded media files into the folder you specified in the fms.ini file (in this example,

C:\Program

Files\Adobe\Flash Media Server 3\applications\vod2\media

The media files are now accessible from the URL

rtmp://

flashmediaserver

/vod2/

filename

Note:

You do not have to specify the media subdirectory in the URL; the media directory is specified in the path you

set in the fms.ini file.

Disable vod services

❖

Move any vod service folders you want to disable out of the applications folder.

Creating clients for streaming services

Creating client applications

Start with the provided sample client code (

RootInstall

/samples/applications/live and

RootInstall

/samples/applica-

tions/vod) and modify it as desired.

Clients for the vod and live services can use any Flash Player features except the following:

•

Recording live streams (

NetStream.publish("streamName", "record")

•

Remote shared objects (

SharedObject.getRemote()

Using the FLVPlayback component

You can use the Flash 8 FLVPlayback component and the Flash CS3 FLVPlayback component as clients for the vod

and live services. Set the

contentPath

parameter to the URL of the stream and, if you’re connecting to the live

service, set the

isLive

parameter to

true

Connecting to a streaming service

The streaming services expect the incoming URI to be in the following format:

rtmp://hostName/serviceName/instanceName/[formatType:]fileOrStreamName

hostName

The Flash Media Server domain name.

serviceName

Either

live

vod

instanceName

If the client is connecting to the default instance, you can either omit the instance name or use

_definst_

. If the client is connecting to an instance you have created, such as

room1

, use that name.

formatType

One of the supported file formats,

flv:

mp3:

mp4:

. The default format if unspecified is

flv:

fileOrStreamName

Either a file name (for example, my_video.mp4) or a pathname (for example,

subdir/subdir2/my_video.mp4). If the file is an FLV or MP3 file, you do not need to specify the file format. If the file

is an MP4 file, you must specify the file format, for example,

rtmp://www.examplemediaserver.com/vod/ClassicFilms/mp4:AnOldMovie.mp4