1.1.7.1 OcaMediaRecorderPlayer

Class Hierarchy:

OcaRoot : OcaWorker : OcaDatasetWorker : OcaMediaRecorderPlayer

class OcaMediaRecorderPlayer : OcaDatasetWorker 

Media volume recorder/player that shall provide streaming data access into and out of OcaDataset objects whose Datasets are media files.

Properties:

static const OcaClassID ClassID = "1.1.7.1"

Number that uniquely identifies the class. Note that this differs from the object number, which identifies the instantiated object. This property is an override of the OcaRoot property.

This property has id 1.1.

static const OcaClassVersionNumber ClassVersion = 3

Identifies the interface version of the class. Any change to the class definition leads to a higher class version. This property is an override of the OcaRoot property.

This property has id 1.2.

OcaMediaPlayOption PlayOption

Play to end of record/play window and leave Dataset open,

Play to end of record/play window, then close Dataset, or

Repeat record/play window until Stop() or Close() is called.

This property has id 4.4.

OcaMediaRecorderPlayerState State

State of this object

This property has id 4.1.

OcaUint16 TrackCount

Number of tracks (signal channels) in the current media volume. Zero if no media volume is open.

This property has id 4.2.

OcaList<OcaMediaTrackFunction> TrackFunctions

List of track functions. Track function determines whether a track (signal channels) will play in a play and/or record operation, and/or record in a record operation.

This property has id 4.3.

OcaMediaVolumePosition WindowEnd

Last position of current record/play window

This property has id 4.6.

OcaMediaVolumePosition WindowStart

First position of current record/play window

This property has id 4.5.

Properties inherited from 1.1.7 OcaDatasetWorker:

Methods:

OcaStatus Open(OcaONo DatasetONo, OcaMediaAccessMode AccessMode, OcaLockState LockState)

Opens a session with a media volume for playing or recording. Request a readonly or exclusive lock, if desired.

This method has id 4.1.

DatasetONo: Input parameter.
AccessMode: Input parameter.
LockState: Input parameter.

OcaStatus Close()

Closes this object’s session on the open media volume.

This method has id 4.2.

OcaStatus Record()

Starts recording immediately. Overwrites the current record/play window, from current position to end.

This method has id 4.3.

OcaStatus Play()

Starts playing immediately. Plays the current record/play window, from current position to end.

This method has id 4.4.

OcaStatus Stop()

Stops playing / recording immediately, does not close session. Leaves Position at (last accessed +1 ).

This method has id 4.5.

OcaStatus Reset()

Stops playing/recording immediately. Resets record/play window range to entire volume. Sets P**osition** to start of volume. Sets PlayOption to Normal. Does **not **reset track functions.

This method has id 4.6.

OcaStatus GetState(OcaMediaRecorderPlayerState &State)

Returns current state of this OcaMediaRecorderPlayer object.

This method has id 4.7.

State: Output parameter.

OcaStatus GetTrackCount(OcaUint16 &TrackCount)

Returns track count of currently open media volume, or zero if no volume is open.

This method has id 4.8.

TrackCount: Output parameter.

OcaStatus SetTrackCount(OcaUint16 TrackCount)

Sets track count of currently open media volume. Fails if media volume is not open in RECORD mode, or if no media volume is open.

This method has id 4.9.

TrackCount: Input parameter.

OcaStatus GetTrackFunctions(OcaList<OcaMediaTrackFunction> &Functions)

Returns the list of track functions.

This method has id 4.10.

Functions: Output parameter.

OcaStatus SetTrackFunctions(OcaList<OcaMediaTrackFunction> Functions)

Sets the list of track functions. Fails if no media volume is open.

This method has id 4.11.

Functions: Input parameter.

OcaStatus GetPlayOption(OcaMediaPlayOption &Option)

Returns value of PlayOption property.

This method has id 4.12.

Option: Output parameter.

OcaStatus SetPlayOption(OcaMediaPlayOption Option)

Sets value of PlayOption property.

This method has id 4.13.

Option: Input parameter.

OcaStatus GetPosition(OcaMediaVolumePosition &Position)

Returns current media position or null value if no media volume is open. Value is relative to the start of the current interval.

This method has id 4.14.

Position: Output parameter.

OcaStatus SetPosition(OcaMediaVolumePosition Position)

Sets media position. Value is relative to the start of the current interval.

This method has id 4.15.

Position: Input parameter.

OcaStatus GetWindowRange(OcaMediaVolumePosition &FirstPosition, OcaMediaVolumePosition &LastPosition)

Returns start and end point positions of current record/play window.

This method has id 4.16.

FirstPosition: Output parameter.
LastPosition: Output parameter.

OcaStatus SetWindowRange(OcaMediaVolumePosition FirstPosition, OcaMediaVolumePosition LastPosition)

Sets start and end point positions of current record/play window.

This method has id 4.17.

FirstPosition: Input parameter.
LastPosition: Input parameter.

Methods inherited from 1.1.7 OcaDatasetWorker: