Variables | |
| long | AudioBitrate |
| Audio data rate in kilobits. [RW]. | |
| long | AudioCaptureBufferTime |
| Audio hardware buffer time. [RW]. | |
| string | AudioCaptureDevice |
| Audio capture device selection. [RW]. | |
| long | AudioCaptureMute |
| Not implemented. | |
| long | AudioCaptureVolume |
| Audio capture volume level. [RW]. | |
| long | AudioCodecID |
| Output Audio Format. [RW]. | |
| string | BGImageURL |
| Background image location. [RW]. | |
| long | EncodedDuration |
| Duration encoded. [RO]. | |
| long | EncodeTimeStart |
| Input file start position. [RW]. | |
| long | EncodeTimeEnd |
| Input file stop position. [RW]. | |
| long | FmsEnable |
| Controls Streaming to Flash Media Server. [RW]. | |
| unsigned long | FmsBufferTime |
| Length of FMS stream buffer. [RW]. | |
| long | FmsIgnoreFail |
| Controls Response to FMS Connection Errors. [RW]. | |
| string | FmsServer |
| Flash Media Server Address. [RW]. | |
| string | FmsPath |
| Flash Media Server path. [RW]. | |
| string | FmsName |
| Flash Media Server stream name. [RW]. | |
| long | FmsAuthenticationMode |
| Controls FMS authentication mode [RW]. | |
| long | FmsAuthWaitForResponse |
| Wait for responses from FMS AS function calls. [RW]. | |
| unsigned long | FmsAuthWaitTimeout |
| FMS AS function call response timeout. [RW]. | |
| long | FmsPollEnable |
| Enable/disable FMS connection polling. [RW]. | |
| unsigned long | FmsPollDelay |
| FMS connection poll delay. [RW]. | |
| unsigned long | FmsPollTimeout |
| FMS connection poll timeout. [RW]. | |
| string | FmsUsername |
| Controls FMS user name. [RW]. | |
| string | FmsPassword |
| Controls FMS password. [RW]. | |
| string | FtpSubDomain |
| FTP server sub domain. [RW]. | |
| string | FtpServer |
| Server for ftp uploads. [RO]. | |
| unsigned short | FtpPort |
| FTP port. [RW]. | |
| string | FtpUser |
| Sets user name for ftp uploads. [RW]. | |
| string | FtpPassword |
| Sets password for ftp uploads. [RW]. | |
| string | FtpDestinationFile |
| Sets name of uploaded file. [RW]. | |
| string | FtpMode |
| FTP transfer mode. [RW]. | |
| string | HttpSubDomain |
| HTTP sub domain. [RW]. | |
| string | HttpServer |
| HTTP server address. [RO]. | |
| string | HttpPath |
| HTTP upload Path. [RW]. | |
| string | HttpFile |
| File name on server. [RW]. | |
| string | HttpURL |
| HTTP URL used for publishing. [RO]. | |
| long | InputFileAudioChannels |
| number of audio channels in input file [RO] | |
| long | InputFileAudioSampleRate |
| audio sampling rate of input file [RO] | |
| long | InputFileAudioSampleSize |
| audio sample size of input file [RO] | |
| long | InputFileCanSeek |
| Input file supports seeking [RO]. | |
| long | InputFileDuration |
| Input file duration. [RO]. | |
| double | InputFileFrameRate |
| Input video frames/second [RO]. | |
| string | InputFileName |
| Input file name. [RO]. | |
| long | InputFileSelected |
| Input file selected for playback. [RO]. | |
| long | InputFileWidth |
| Input video width. [RO]. | |
| long | InputFileHeight |
| Input video height. [RO]. | |
| long | LastError |
| Error reporting [RW]. | |
| unsigned long | MaximumCaptureLatency |
| Maximum latency of capture buffers [RW]. | |
| long | MaximumDuration |
| Maximum File Duration [RW]. | |
| long | OutputFileDuration |
| Duration of encoded file. [RO]. | |
| double | OutputFileFrameRate |
| Output Framerate. [RW]. | |
| string | OutputFileName |
| Sets the output file name. [RW]. | |
| long | OutputFileSelected |
| Output file selected for playback. [RO]. | |
| long | OutputFileWidth |
| Encoded Width. [RW]. | |
| long | OutputFileHeight |
| Encoded Height. [RW]. | |
| long | OutputFileWriteEnable |
| Enable/Disable output file writing. [RW]. | |
| long | PlayPosition |
| Playback position. [RW]. | |
| long | PublishMethod |
| Sets the publishing method. [RW]. | |
| long | State |
| State tracking [RO]. | |
| long | UploadedBytes |
| Bytes of publish file uploaded. [RO]. | |
| long | UploadFileSize |
| Size of publish file. [RO]. | |
| string | Version |
| Publisher Version [RO]. | |
| long | VideoBitrate |
| Target VideoBitrate. [RW]. | |
| string | VideoCaptureDevice |
| Video capture device selection. [RW]. | |
| long | VideoBitrateControlMode |
| Flash 8 Video Compressor Data Rate Control Mode [RW]. | |
| long | VideoCompressMode |
| Flash 8 Video Compression Mode [RW]. | |
| long | VideoKeyFrameMode |
| Flash 8 Video Key Framing Mode [RW]. | |
| long | VideoKeyFrameFrequency |
| Flash 8 Video Key Frequency [RW]. | |
When an error occurs, more information can be obtained by catching the exception thrown when the error occurred, or by reading the LastError value.
For general information about errors, please consult the Error Values section.
Each attribute lists exceptions likely to be thrown if something goes wrong. For further information about any errors you encounter while implementing your Flix Publisher project, please contact support.
| long AudioBitrate |
Desired bit rate, in kilobits per second, for the output audio stream. The default value of AudioBitrate is 32 kilobits per second.
Length of audio hardware capture buffer, in milliseconds.
| string AudioCaptureDevice |
Controls the audio capture source. This attribute is read/write.
| FE_CAPTURE_A | - if device fails basic render tests. | |
| FE_IN_USE | - if written while capture or preview in progress. | |
| FE_NO_CAPTURE_DEVICE | - if selected device disconnected. |
| long AudioCaptureMute |
Not implemented. Once implemented, will mute audio capture.
| long AudioCaptureVolume |
Controls audio capture volume. Range is 0-100, default is 50.
| long AudioCodecID |
This attribute controls the audio codec used in FLV files encoded by the publisher plug-ins. This attribute supports reading and writing. The default codec is kAudioCodecNellyMoser. The supported AudioCodecID values are:
| string BGImageURL |
Holds complete URL for image to be displayed by the plug-in when it is idle. This attribute is read/write.
| long EncodedDuration |
Duration, in milliseconds, of the portion of the input file already encoded. This attribute is read-only. The value read is invalid if no encode is in progress. Values are in milliseconds.
| long EncodeTimeStart |
Point in the input file at which encoding should be started. This attribute is read/write. Values are in milliseconds. The default EncodeTimeStart is 0.
| FE_FILE_CANNOT_SEEK | - the current file does not allow seeking. |
| long EncodeTimeEnd |
Point in the input file at which encoding should stop. This attribute is read/write. Values are in milliseconds. The default EncodeTimeEnd is InputFileDuration.
| long FmsEnable |
This attribute enables and disables streaming of FLV output data to a Flash Media Server while encoding is in progress. This attribute supports reading and writing. The default value is 0, disabled. The supported values for FmsEnable are:
| unsigned long FmsBufferTime |
Milliseconds buffered within the FMS streaming support library. The default value is 0, no buffering. No buffering means that the library attempts to send the data to FMS as quickly as possible.
| long FmsIgnoreFail |
The value of this attribute determines how the plug-in responds to a Flash Media Server connection error. This attribute supports reading and writing. Its possible values are:
| string FmsServer |
| string FmsPath |
This attribute controls the path portion of URL used to connect to FMS. This attribute supports reading and writing.
For example, in the URL rtmp://fms.on2.com/streams/stream1, the streams/stream1 portion is controlled by this attribute.
| string FmsName |
This attribute controls the stream name used to connect and send data to FMS. FLV streaming from FMS requires a stream name in addition to the URL. This attribute supports reading and writing.
FmsAuthenticationMode controls the authentication method used to communicate and authenticate with the destination server for your encoded stream. The only currently supported values are:
If FmsAuthWaitForResponse is enabled, the plug-in will wait for a response from each FMS Action Script function call.
| unsigned long FmsAuthWaitTimeout |
Milliseconds the plug-in will wait for a response from a FMS Action Script function call.
| long FmsPollEnable |
Enables and disables FMS connection polling. Use FmsPollTimeout to set the polling timeout. Examples demonstrating this can be found in flixpub_conf.js and flixpub_main.js.
| unsigned long FmsPollDelay |
Milliseconds between FMS connection poll attempts. The default polling delay is 10000 milliseconds.
| unsigned long FmsPollTimeout |
Milliseconds plug-in waits for a response from FMS before the connection is timed out. The default time out value is 10000 milliseconds.
| string FmsUsername |
This attribute exists and can be read and written. Unfortunately, using an FMS user name is only supported in specific FMS Authentication schemes. These schemes have not yet been completed. Check back here for futher information in future releases.
FmsUsername holds the user identifier/name that will be used to authenticate the stream on the destination Flash Media Server. FmsUsername is only used when FmsAuthenticationMode is non-zero.
| string FmsPassword |
This attribute exists and can be read and written. Unfortunately, using an FMS password is only supported in specific FMS Authentication schemes. These schemes have not yet been completed. Check back here for futher information in future releases.
FmsPassword holds the password/key that will be used to authenticate the stream on the destination Flash Media Server. FmsPassword is only used when FmsAuthenticationMode is non-zero.
| string FtpSubDomain |
This attribute controls the sub domain portion of the FTP server address. This attribute supports reading and writing.
For example, given the address ftp.example.com, the ftp portion would be controlled by this attribute.
| string FtpServer |
Server address for FTP uploading. This attribute is read-only.
| unsigned short FtpPort |
| string FtpUser |
Sets user account name for ftp publishing. This attribute is read/write.
| string FtpPassword |
Sets password for ftp publishing. This attribute is read/write.
| string FtpDestinationFile |
Sets file name for ftp publishing. The file will be stored on the server with the specified name. This attribute is read/write.
| string FtpMode |
Enables or Disables Passive mode. Passive mode FTP uploading is enabled by default, thus the default value of FtpMode is "P". To disable passive mode, set ftpMode to any value other than "P". (not recommended)
| string HttpSubDomain |
The HttpSubDomain contains the portion of the URL that is typically set to 'www'. When the publisher starts an http upload, the url formed will be:
http://HttpSubDomain.HttpServer/HttpPath
| string HttpServer |
The Http server address you provided during the publisher licensing process. When the publisher starts an http upload, the url formed will be:
http://HttpSubDomain.HttpServer/HttpPath
| string HttpPath |
The HttpPath contains everything that gets appended after the domain/ip in the http url. When the publisher starts an http upload, the url formed will be:
http://HttpSubDomain.HttpServer/HttpPath
This attribute is read-only.
| string HttpFile |
This attribute controls the name of the file once uploaded to the server. This attribute is read/write.
| string HttpURL |
Use this read-only property to determine the url that will be used to create the HTTP post sent to the web server.
http://HttpSubDomain.HttpServer/HttpPath
This attribute holds the number of audio channels detected in the input file when checkInputFile() was called. This attribute is read-only.
This attribute holds the audio sampling rate of the input file detected when checkInputFile() was called. The value returned is in hertz. This attribute is read-only.
This attribute holds the audio sampling rate of the input file detected when checkInputFile() was called. The value returned is in bits. This attribute is read-only.
| long InputFileCanSeek |
This attribute must be checked before setting PlayPosition or EncodeTimeStart. Writes to either attribute when InputFileCanSeek is false will result in FE_FILE_CANNOT_SEEK exceptions being thrown. This attribute is read-only.
| long InputFileDuration |
Duration, in milliseconds, of input file. This attribute is read-only. Values are in milliseconds.
| double InputFileFrameRate |
Contains input file frame rate. This attribute is read-only.
| string InputFileName |
The full name and path of the current input file. The attribute is read-only.
| long InputFileSelected |
If non-zero, the input file is currently selected.
| long InputFileWidth |
Width, in pixels, of input file. This attribute is read-only.
| long InputFileHeight |
Height, in pixels, of input file. This attribute is read-only.
| long LastError |
Contains the value of the most recent error. It is best to reset this value prior to eash interaction with the publisher in order to guarantee valid information when reading the value.
| unsigned long MaximumCaptureLatency |
MaximumCaptureLatency controls the maximum amount of buffering allowed within the capture data stream. The value is in milliseconds. The default value is 0 milliseconds.
0ms system defaults are used 100ms is not recommended because most audio and video capture hardware is not capable of keeping up with such a low capture latency. 250ms is not recommended, it can cause loss of audio video synchronization.| long MaximumDuration |
Contains the maximum duration, in milliseconds, for files created by the Publisher. This attribute is read/write.
120000 milliseconds, or 2 minutes. | long OutputFileDuration |
Duration of output file, in milliseconds. This attribute is read-only.
| double OutputFileFrameRate |
This attribute controls the video frame rate of the output file. This attribute is read/write.
| string OutputFileName |
Sets output file to the name and path specified. This attribute is read/write.
The full path to the output file name specified must exist. If a directory in the path does not exist, startCapture() will fail. The same is true for startFileEncode().
| long OutputFileSelected |
If non-zero, the output file is currently selected.
| long OutputFileWidth |
Width, in pixels, of output file. This attribute is read/write. The default value for OutputFileWidth is 320 pixels.
| long OutputFileHeight |
Height, in pixels, of output file. This attribute is read/write. The default value for OutputFileHeight is 240 pixels. For input files with aspect ratios not equal to 4:3, the default value of OutputFileHeight will be adjusted to maintain aspect ratio when checkInputFile() is called.
To disable output file writing, set OutputFileWriteEnable to true. Output file writing can only be disabled for capture.
| long PlayPosition |
The current playback time. This attribute is read/write. Values are in milliseconds.
When written, if the file allows seeking, seeks within the file that's currently playing. When read, returns playback position.
| FE_FILE_CANNOT_SEEK | - file playing does not allow seeking. |
| long PublishMethod |
Determines the upload method used when publishFile() is called. This parameter is read/write. The default publishing method is kUploadModeFtp.
| long State |
Returns the current publisher state. This parameter is read-only.
| long UploadedBytes |
Holds the number of bytes actually uploaded from the publish file. This attribute is read-only.
| long UploadFileSize |
Holds the total size of the file uploading. This attribute is read-only.
| string Version |
Current version of Flix Publisher.
| long VideoBitrate |
Holds the video bitrate of the output file. This attribute it read/write. The default VideoBitrate is 200 kilobits per second. The value must be set before encoding is started.
| string VideoCaptureDevice |
Controls the video capture source. This attribute is read/write.
| FE_CAPTURE_V | - if device fails basic render tests. | |
| FE_IN_USE | - if written while capture or preview in progress. | |
| FE_NO_CAPTURE_DEVICE | - if selected device disconnected. |
This attribute controls the mode of the of the On2 VP62 (Flash 8) video encoder's bitrate controller. This attribute supports reading and writing.
The default value of the VideoBitrateControlMode attribute is kBitrateModeCBR. The supported VideoBitrateControlMode values are:
| long VideoCompressMode |
This attribute controls the speed of the On2 VP62 (Flash 8) video encoder when the publisher is transcoding a file. This attribute supports reading and writing.
The default value of the VideoCompressMode attribute is kCompressModeRealTime. The supported VideoBitrateControlMode values are:
| long VideoKeyFrameMode |
This attribute controls the mode of the algorithm used to determine keyframe placement in output video. This attribute supports reading and writing.
The default value of the VideoKeyFrameMode attribute is kKeyframeModeAuto. The supported VideoKeyFrameMode values are:
This attribute controls the frequency of keyframes in the video output. This attribute supports reading and writing. The default value of VideoKeyFrameFrequency is 75.
The bahavior of this attribute varies based on the value of VideoKeyFrameMode: