|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.ocap.dvr.BufferingRequest
public abstract class BufferingRequest
This class represents an application request for buffering. An application
can call the createInstance
method to create a request.
Constructor Summary | |
---|---|
protected |
BufferingRequest()
Protected constructor, not to be used by applications. |
Method Summary | |
---|---|
static BufferingRequest |
createInstance(javax.tv.service.Service service,
long minDuration,
long maxDuration,
ExtendedFileAccessPermissions efap)
Creates a BufferingRequest object. |
abstract AppID |
getAppID()
Gets the AppID of the application that created the request. |
abstract ExtendedFileAccessPermissions |
getExtendedFileAccessPermissions()
Gets the ExtendedFileAccessPermissions for this request. |
abstract long |
getMaxDuration()
Gets the maximum duration to buffer for this request. |
abstract long |
getMinimumDuration()
Gets the minimum content buffering duration for this request. |
abstract javax.tv.service.Service |
getService()
Gets the Service this request is attempting to buffer. |
abstract void |
setExtendedFileAccessPermissions(ExtendedFileAccessPermissions efap)
Sets the ExtendedFileAccessPermissions for this request. |
abstract void |
setMaxDuration(long duration)
Sets the maximum duration of content that MAY be buffered for this BufferingRequest . |
abstract void |
setMinimumDuration(long minDuration)
Sets the minimum duration of content that SHALL be buffered for this request. |
abstract void |
setService(javax.tv.service.Service service)
Sets the Service this request is attempting to buffer. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
protected BufferingRequest()
Method Detail |
---|
public static BufferingRequest createInstance(javax.tv.service.Service service, long minDuration, long maxDuration, ExtendedFileAccessPermissions efap)
service
- The service to buffer.minDuration
- Minimum duration in seconds to buffer.maxDuration
- Maximum duration in seconds to buffer.efap
- Extended file access permissions for this request. If this
parameter is null, no write permissions are given to this request.
Read permissions for BufferingRequest
instances are
always world regardless of read permissions set by this parameter.
java.lang.IllegalArgumentException
- if the service parameter is not a valid
Service
, or if minDuration
is less than
OcapRecordingManager.getSmallestTimeShiftDuration()
, or if
maxDuration
is less than minDuration
.public abstract javax.tv.service.Service getService()
public abstract void setService(javax.tv.service.Service service)
service
- The Service
to buffer for this request.
java.lang.IllegalArgumentException
- if the parameter is not a valid
Service
.
java.lang.SecurityException
- if the calling applications does not have one
of the write ExtendedFileAccessPermissions set by the
createInstance
or
setExtendedFileAccessPermissions
methods.public abstract long getMinimumDuration()
public abstract void setMinimumDuration(long minDuration)
minDuration
- Minimum duration in seconds.
java.lang.IllegalArgumentException
- If the parameter is greater than the current
value and Host device does not have enough space to meet the request, or if
the parameter is greater than the maximum duration set by the
createInstance
or setMaximumDuration
methods,
or if the parameter is less than the duration returned by
OcapRecordingManager.getSmallestTimeShiftDuration()
.
java.lang.SecurityException
- if the calling application does not have one
of the write ExtendedFileAccessPermissions set by the
createInstance
or
setExtendedFileAccessPermissions
methods.public abstract long getMaxDuration()
createInstance
or
setMaximumDuration
methods.
public abstract void setMaxDuration(long duration)
BufferingRequest
. Informs the implementation that
storing more content than this is not needed by the application
owning this BufferingRequest
.
duration
- The maximum duration in seconds.
java.lang.IllegalArgumentException
- if the duration parameter is negative
or if the parameter is less than the minimum duration set by the
createInstance
or setMaximumDuration
methods, or if the parameter is less than the duration returned by
OcapRecordingManager.getSmallestTimeShiftDuration()
.
java.lang.SecurityException
- if the calling application does not have one
of the write ExtendedFileAccessPermissions set by the
createInstance
or
setExtendedFileAccessPermissions
methods.public abstract ExtendedFileAccessPermissions getExtendedFileAccessPermissions()
public abstract void setExtendedFileAccessPermissions(ExtendedFileAccessPermissions efap)
efap
- The ExtendedFileAccessPermissions for this request.
java.lang.IllegalArgumentException
- if the parameter is null;
java.lang.SecurityException
- if the calling application is not the creator
of this request.public abstract AppID getAppID()
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |