FIELD OF THE INVENTION
The present invention relates to a transcoding system comprising an application platform and a transcoding platform for executing transcoding transactions that comprise the following steps:
- transmission of a request from said application platform to said transcoding platform,
- execution of said request by said transcoding platform,
- transmission of a response from said transcoding platform to said application platform.
In the present description, the word “platform” refers to a combination of hardware and software that provides the functionality of the concerned applications.
BACKGROUND OF THE INVENTION
The deployment of multimedia applications like MMS Multimedia Messaging Service), WAP 2 (Wireless Application Protocol), e-mail, web browsing . . . etc.) may require some Content adaptations, due to the diversity of the phone specifications (memory, screen size, resolution, colour depth, etc, and supported media formats) and of the media formats as distributed by the Content industry (JPEG, GIF, all AMR modes, 13K vocoder, EVRC, SMV, MPEG-1, MPEG-4, H.263 . . . etc.). The word “Content” used here means any subject matter or information that is processed, stored or transmitted electronically. Content Adaptation is largely independent on the type of service that delivers the data to the end users. In this context, STI 1.0 is the first specification of a standard interface between the Multimedia Application Platforms and the Transcoding Platform and is meant to resolve some of the integration and testing problems when deploying multimedia services towards mobile devices.
SUMMARY OF THE INVENTION
The object of the invention is to propose a new solution for the standard interface, to be used by OMA STI 1.0. (OMA=Open Mobile Alliance).
To this end, the invention relates to a transcoding system such as defined in the introductory paragraph of the description and in which said request is based on a request body which is structured as indicated in Table 1, and said response, when successful, is based on a response body which is structured as indicated in Table 3.
BRIEF DESCRIPTION OF THE DRAWINGS
The present invention will now be described, by way of example, with reference to the accompanying drawings in which:
FIG. 1 illustrates a transcoding transaction;
FIG. 2 shows an overview of the request components for such a transaction;
FIG. 3 presents the transcoding job structure, including the source parameters and the target parameters,
FIG. 4 presents the response transaction structure, and
FIG. 5 presents the job result structure;
FIG. 6 is an example of combined media format;
FIG. 7 shows the structure of a request transaction, and
FIG. 8 the structure of a response transaction.
DETAILED DESCRIPTION OF THE INVENTION
A high level overview of the interaction between an Application Platform 10 and a Transcoding Platform 20 is illustrated in FIG. 1. The communication between the Platforms is transactional, that is a transcoding session is always a request 30 followed by a response 40. A session is closed only when a response has been received. The Application Platform requests transcoding from the Transcoding Platform. The Transcoding Platform receives the request, parses it, handles it and generates a response to the originating Application Platform.
The choice of the protocol is done as follows. The interface between Application Platform and the Transcoding Platform relies on a SOAP protocol (SOAP v 1.1, http://www.w3.org/TR/SOAP/), sent over HTTP (HyperText Transfer Protocol) and used over TCP/IP (Transmission Control Protocol/Internet Protocol).
FIG. 2 shows an overview of the request components. Multiple bulk transcoding within a single Request Transaction (=transcoding request, as issued by the Application Platform; it can contain one or more Transcoding Jobs 1 to N and one or more Content Attachments 1 to M, a Transcoding Job being the part of the Request Transaction that corresponds to one individual transcoding, i.e. one input content reference and the parameters corresponding to the particular transcoding as given by the Application Platform) is allowed by the proposed interface: therefore one will distinguish between Transcoding Job (individual media transcoding) and Request Body (list of Job results) which can contain one or several Jobs as part of one single request to the Transcoding Platform. For each single Transcoding Job within a Request body, the transcoding parameters are specified within the SOAP context. In case a Transcoding Job contains the Content files themselves, they are attached inside the concerned message, but outside the SOAP envelope. Each Transcoding Job in a Request Body has to contain the source parameters (format, type, location, etc) and the target parameters (profile ID, transcoding parameters, location, policy ID, policy parameters, etc), as presented in FIG. 3. The proposed Request Transaction structure supports all the Content types within the scope of STI 1.0: images, audio, speech, video, text, presentation formats and combined media . . . etc.
The Response transaction (response of the Transcoding Platform to the Request Transaction) contains the Job Results (the Transcoding Jobs' results 1, 2, . . . , N), as presented in FIG. 4. In this Response Body, parameters (duration, return code, etc) either concern the whole Transaction or the individual Transcoding Jobs' results. For example, the duration corresponds to the complete Transaction duration. Still, in the job Results, there might also be some parameters describing the particular transcoding that was performed (i.e. image 1 was transcoded from GIF—Graphic Interchange Format—to JPEG—Joint Photographic Experts Group). The proposed interface supports reporting of statistical data gathered during the transcoding at the Job and Transaction levels. The Job Results contained in the Transaction are detailed in FIG. 5. The Source block of each Transcoding Job may specify the source type, format and parameters. The Target block of each Transaction Job has to specify the desired transcoding parameters and can specify Policy parameters.
The proposed interface also supports transcoding of combined media Content, i.e a set of media elements can be transcoded as a whole. In this case, it is expected that the Transcoding Platform receives a combined media file, performs combined transcoding of the difference media elements (including any logical decisions between the different media elements) and recombines these elements into one transcoded combined media file as a response. The combined-media is transferred as a MIME-Multipart content item (MIME Part 1 (2, 3, . . . ): see http://www.ietf.org/rfc/rfc2045(to2049).txt). The MIME type is either multipart/related (in case a presentation exists) or multipart/mixed (in case a presentation does not exist). In the first case, the start parameter refers to the presentation part. FIG. 6 illustrates the structure of a combined media (with a presentation part). The encoding of the MIME-Multipart (both input and output) is either textual, as defined in [MIME], or WAP binary encoding, as defined in [WAPWSP] (“Wireless Application Protocol, Wireless Session Protocol Specification”, WAP-203-WSP-20000504-a, WAP Forum™. URL [Uniform Resource Locator]=http://www.openmobilealliance.org). The requested encoding for the target MIME-Multipart is specified in the transcoding parameters of the Transcoding Job. The Content data (either combined media or individual media parts) is referenced from within the SOAP Request Body (and Response Body), and resides either on a storage that can be accessed by the Transcoding Platform or attached as part of the Transaction itself. The proposed interface provides two methods of supporting media attachments:
self contained requests, in which the content data reside within the Transaction itself;
references to external Content elements, in which case the Transaction only contains a pointer to a remote location from where the Content elements can be pulled by the Transcoding Platform.
Each of the methods will be described below (note that the two options can be combined within one Transaction containing references (URLs) to external Content elements and attached Content elements). In the case references to external Content elements are used, the SOAP Request/Response Body contains the URLs, pointing to the relevant files, and the Application Platform and the Transcoding Platform have access to a shared persistent storage device, either “local” or accessible via HTTP or FTP (File Transfer Protocol). In case of self-contained requests, the SOAP Request/Response Body contains references to the attachments sent along with the Transaction, as MIME parts. Each content attachment is identified by its MIME Content ID. The SOAP Request/Response Body refers to the content, using the Content IDs.
The transcoding parameters are the parameters that determine the target the Transcoding platform has to create. To specify the transcoding parameters, the Application Platform uses predefined Profiles and/or explicit transcoding parameters (note that in all cases, the Transcoding Platform can complement the list of parameters, but one of the Transcoding Platform parameters overrides the parameters that the Application Platform indicated in the Request Transaction). The transcoding parameters can be indicated using a reference to a pre-defined Profile (a profile is a set of parameters and constraints that define the transcoding target). One common use of a Profile is to describe the user Equipment (=a device allowing a user access to network services) characteristics. The profile reference can then be a reference to the database that both the Transcoding and Application Platforms share. In order to use a predefined profile, the Request Transaction specifies the Profile ID of the profile to be used (the definition of a profile and its content are out of the scope of the present description). The transcoding parameters can also be indicated using an explicit list of parameters, which will reflect the characteristics of the target device and/or the specific requirements from the Application. When a Profile ID is indicated and explicit parameters are added, the explicit parameters override the corresponding parameters in the referenced Profile.
Policy parameters are a mean for the Application Platform to specify general rules (general limitations and preferences) for the Request Transaction (i.e. priority order between the different media elements, . . . ). To specify the Policy parameters, the Application Platform uses predefined Policy and/or explicit Policy parameters. When a PolicyID is indicated and explicit policy parameters are added, the explicit parameters override the corresponding parameters in the referenced Policy.
The request transaction will now be explained in detail. As mentioned above, the Request Transactions contain a SOAP header, made of Transcoding Jobs, and can contain one or several Content attachments (if some Content elements are contained in the Transaction itself). All Content elements to be transcoded are referenced in the Transcoding Jobs (pointing to an attachment or an external source). The Request Transaction contains at least one Transcoding Job, and it can contain several Transcoding Jobs. FIG. 7 shows the structure of a Request Transaction. Request Transactions that do no contain attachments (all the files are referenced using a URLs pointing to external sources) have a SOAP header and a SOAP-based Request Body. The SOAP header specifies the originating host, the length, the request encoding and the SOAP action. Request Transactions with Content attachments contain the SOAP header and a string that will indicate the boundary between each content attachment, as defined in MIME (see [MIME]). Each Content attachment contains its own header (using MIME). Each Content Attachment header contains its unique ID, its type, its encoding and its length.
According to the invention, the SOAP-based Request Body is structured as indicated in the following Table 1 (in which the structures are written in bold):
TABLE 1
|
|
Mandatory/
parentNameTypePossible ValuesOptionalComments
|
TransactionMandatorySeveral Transcoding Jobs
can be sent within one
request.
TransactionTransactionIDIntegerMandatoryA unique ID that is given by
the Application Platform.
TransactionNumTranscodingJobsIntegerOptionalHow many Transcoding
Jobs reside in this
Transaction.
TransactionPriorityInteger0-2OptionalThe priority of the
Transaction (0 is the
highest, default is 1)
compared to others.
TransactionProfileIDStringOptionalThe pre-defined Profile to be
used for all the Transcoding
Jobs within this Transaction.
TransactionTranscodingParamsOptionalThe transcoding parameters
to be used for all the
Transcoding Jobs within
this Transaction. When a
predefined Profile is
specified and this tag
appears, the values specified
within this tag override the
ones in the Profile.
TransactionPolicyIDStringOptionalThe pre-defined policy to be
used for the Transaction.
TransactionPolicyParamsOptionalThe policy rules to be used
for this Transaction. When a
predefined Policy is
specified and this tag
appears, the values specified
within this tag override the
ones in the Policy.
TransactionTranscodingJobMandatoryEach individual transcoding
(1 or more)request.
TranscodingJobSourceMandatoryThe source for the
Transcoding Job.
TranscodingJobTargetMandatoryThe Target of this
Transcoding Job.
SourceTypeString“Combined”,OptionalThe type of the Source.
“Audio”,
“Image”,
“Video”,
“Text”,
“SyntheticAudio”
SourceFormatStringAccording to theOptionalThe format of the Source.
supported formats
SourceCodecStringAccording to theOptionalThe codec of the Source.
supported codecs
SourceLocationStringURLMandatoryThe full-path on a shared
storage or the Content ID of
the attachment
SourceURLSettingsIDStringOptionalIf any specific settings
(headers, passwords, etc.)
should be used, in order to
access the Source URL, then
the Application Platform
SHALL specify a reference
to such a set of predefined
settings through this
parameter.
The definition of the set of
available settings is out of
the scope of this specification
TargetProfileIDStringOptionalA predefined Profile to use
for the Transcoding Job.
When a ProfileID is defined
at the Transaction level and
this tag is present at the
Transcoding Job level, the
ProfileID at the Transcoding
Job level overrides the one
at the Transaction level.
TargetTranscodingParamsOptionalThe transcoding parameters
to be used for all the
Transcoding Jobs within
this Transaction. When a
predefined Profile is
specified and this tag
appears, the values specified
within this tag override the
ones in the Profile. When
TranscodingParams are
defined at the Transaction
level and this tag is present
at the Transcoding Job level,
the TranscodingParams at
the Transcoding Job level
override the ones at the
Transaction level.
TargetLocationStringURLMandatoryThe full-path on a shared
storage or the Content ID of
the attachment.
TargetURLSettingsIDStringOptionalIf any specific settings
(headers, passwords, etc.)
should be used, in order to
access the Target URL, then
the Application Platform
SHALL specify a reference
to such a set of predefined
settings through this
parameter.
The definition of the set of
available settings is out of
the scope of this
specification.
PolicyParamsDeleteOrderOptionalOrdered list of media types
to be deleted if necessary.
PolicyParamsCompressOrderOptionalOrdered list of media types to
compressed if necessary
DeleteOrderMediaTypeString“Audio”,Optional (1Media types in order of
“Image”,or more)deletion.
“Video”,
“Text”,
“SyntheticAudio”,
“Combined”
CompressOrderMediaTypeString“Audio”,Optional (1Media types in order for
“Image”,or more)compression.
“Video”,
“Text”,
“SyntheticAudio”,
“Combined”
TranscodingParamsSizeLimitIntegerOptionalThe limit of the file sizes for
the Transaction or the
TranscodingJob. Default is
unlimited (−1)
TranscodingParamsAudioOptionalThe audio transcoding
parameters.
TranscodingParamsImageOptionalThe image transcoding
parameters (also graphics).
TranscodingParamsVideooptionalThe video transcoding
parameters.
TranscodingParamsTextOptionalThe text transcoding
parameters.
TranscodingParamsCombinedMediaOptionalThe combined-media
transcoding parameters.
TranscodingParamsTransformationOptional (0transformation that the
or morecontent should go through
appearances)
TransformationTypeStringAccording to theOptionalType of transformation
supported
Transformations
TransformationparameterStringAccording to theOptionalValue of parameter for this
SupportedTransformation
parameter values
for the specific
transformation
AudioFormatStringAccording to theOptionalThe file-format of the target.
supported audioAny supported audio
formats
AudioCodecStringAccording to theOptionalThe desired codec.
supported audioRestricted by the file format
codecs
AudioBitRateIntegerOptionalThe desired bit-rate.
Restricted by the codec
AudioSamplingRateIntegerOptionalThe desired sampling rate.
Restricted by the codec
AudioSamplingResolutionIntegerOptionalThe desired sampling
resolution. Restricted by the
codec
AudioSyntheticOptionalSynthetic audio related
parameters.
SyntheticChannelToUseIntegerOptionalNumber of input channel to
be used in case the output
contains only one channel.
SyntheticChannelsPriorityStringOptionalA comma separated
permutation of 0-15. The
priority of the channels, from
the most important to the
least important.
Default is 0-15.
SyntheticInstrumentIntegerOptionalThe instrument to use, when
transcoding to midi.
Irrelevant for other formats,
default is piano
AudioSizeLimitIntegerOptionalThe limit of the file size for
an audio. Default is
unimited (−1)
ImageFormatStringAccording to theOptionalThe format of the target.
supported imageAny supported image
formats
ImageColorSchemeString“True24Bit”,OptionalThe desired color scheme
“True12Bit”,
“Palette256Co”,
“Palette256Gr”,
“Palette32Co”,
“Palette32Gr”,
“Palette16Co”,
“Palette16Gr”,
“Palette4Co”,
“Palette4Gr”,
“1Bit”
ImageWidthIntegerOptionalThe target width.
The default is the original
width.
ImageHeightIntegerOptionalThe target height.
The default is the original heig
ImageResizeString“AspectRatio”,OptionalMaintain the aspect ratio
Policy“Crop”, “None”when resizing (the new
dimensions are set to fit into
the desired width while
aspect ratio is maintained),
crop when shrinking (do not
scale the image - take its
central rectangle), or just
stretch.
ImageSizeLimitIntegerOptionalSize limit for the image.
Default is unlimited (−1)
VideoFormatStringAccording to theOptionalThe format of the target.
supported videoAny supported video
formats
VideoCodecStringAccording to theOptionalThe video codec of the
supported videotarget.
codecs
VideoWidthIntegerOptionalTarget width
VideoHeightIntegerOptionalTarget height
VideoFrameRateIntegerOptionalThe wanted target frame rate
VideoBitRateIntegerOptionalThe desired target bit rate
VideoAudioOptionalAudio parameters.
VideoSizeLimitIntegerOptionalSize limit for the Audio.
Default is unlimited (−1)
CombinedMediaSizeLimitIntegerOptionalSize limit for the whole
combined media.
Default is unlimited (−1)
CombinedMediaPresentationParamsOptionalParameters for the target
presentation.
PresentationParamsFormatString“SMIL”,OptionalTarget presentation format
“HTML”, “None”
PresentationParamsTemplateStringOptionalTemplate for presentation to
be used in case of
presentation format change.
This is either a URL, or a
content ID of the attachment
PresentationParamsLayoutString“Portrait”,OptionalTarget layout.
“Landscape”Default is the source layout.
CombinedMediaEncodingString“Textual”,OptionalThe encoding of the output
“WAP”MIME-Multipart.
Default is textual.
CombinedMediaTranscodingParamsOptionalTranscoding Parameters for
media-elements inside the
combined-media (more than
one media type may be
specifled here). The
Parameters are specified for
all the content-elements of
the same type.
For example, in order to
transcode a video to a
combined-media (e.g.
image/s + audio + presentation),
the target Parameters for
the audio, image, and
presentation are specified
here.
CombinedMediaOverallParamsOptionalLimitations on media
parameters in the combined-
media.
OverallParamsWidthIntegerOptionalTarget width
OverallParamsHeightIntegerOptionalTarget height
OverallParamsBitsPerPixelIntegerOptionalSupported Number of bits
per pixel
OverallParamsAllowColorBooleanOptionalIndication whether color
images are allowed as an
output.
OverallParamsMaxImageWidthIntegerOptionalMaximum width
allowed for
image.
OverallParamsMaxImageHeightIntegerOptionalMaximum height
allowed for
an image.
OverallParamsAllowImageBooleanOptionalIndication whether
output
can contain image.
OverallParamsAllowAudioBooleanOptionalIndication whether
output
can contain audio.
OverallParamsAllowVideoBooleanOptionalIndication whether
output can contain video
OverallParamsSupportedContentTypesOptionalA list of the supported
content types.
SupportedContentTypesTypeStringOptionalA single content type
1 or more)
|
In order to perform transformations on the media, the Application Platform specifies, for each requested transformation, the type of the transformation and the parameter for the transformation. The following Table 2 lists the minimal set of supported transformations, the allowed parameter values for these transformations, and the type (or types) of media elements on which these transformations may be used. STI supports other proprietary Transformations that will then have to be defined between the Application Platform and the Transcoding Platform. If the Transcoding Platform does not recognize the Transformation type, it returns an error.
TABLE 2
|
|
Transformation
TypePossible parameter valuesMedia TypesDescription
|
LevelCorrectionNo parameterImagePerform level correction.
Mirror“UD”, “LR,Image“UD” - vertical mirror, “LR” -
“Diagonal”,horizontal mirror. Default is
“None”“None”.
NoiseReductionNo parameterImagePerform noise reduction.
RotationAngle of clockwiseImagePerform Image rotation
rotation (0-359)
SharpenNo parameterImagePerform image sharpening.
DurationLimitLimit on duration (inVideo, Audio,Truncate the media if its duration
milliseconds)CombinedMedia (e.g.exceeds this limit.
for slideshow)
AGCNo parameterAudioPerform Automatic Gain Control
OffsetOffset in source mediaAudio, Videothe source image to start the
(inTranscoding from.
milliseconds)
AudioChannels“Mono”, “Stereo”,AudioChange the number of channels
“DualMono”,in the output.
“IntensityStereo”
FrameRateSampleNew frame rateImage (e.g. forChange the frame sampling rate
slideshow)(without changing the speed and
the duration of the media)
FrameRateOutputNew frame rateImage (e.g. forChange the frame rate in the
slideshow)output (and thus change also
the speed and the duration of
the media).
NumberOfFramesNew number of framesImage (e.g. forChange the number of frames in
slideshow)the output.
|
A request Transaction is considered as successful unless there was an error during the handling of the transaction that prevented the completion of the whole Transaction. Errors in specific Transcoding Jobs do not affect the success value of the entire Request Transaction. That is, a Request Transaction may be successful even though some (or all) of the Transcoding Jobs failed. The structure of a successful Response Transaction, containing the results of one or more Transcoding Jobs, is quite similar to the Request Transaction, i.e. a SOAP header, including a success code, and one or more Job Results and optionally the Content attachments. The Response Body contains references to either external content element or self-contained content elements. The same differences between a Transaction with contained content elements and without contained content elements, as discussed in the Request Transaction, apply for Response Transactions. FIG. 8 shows the structure of the Response Transaction. As for the Request Body, a table indicates (Table 3) how the Response Body is structured:
TABLE 3
|
|
ParentNameTypePossible valuesComments
|
TransactionThe response
TransactionReturnCodeIntegerThe return code of the
Transaction (either a
successful or a warning)
TransactionNumJobResultsIntegerHow many Job Results
residue in this response.
TransactionProfileIDStringThe Profile ID that was
used for this transaction
(in case it was specified
in the Transaction block
of the request)
TransactionPolicyIDStringThe Policy ID that was
used for this transaction
(in case it was specified
in the Transaction block
of the request)
TransactionTransactionIDIntegerThe unique ID that was
received from the
Application Platform in
the request
TransactionContextIDIntegerA unique ID of the
transcoding session
that is given by the
Transcoding Platform.
TransactionTotalDurationIntegerThe time it took the
Transcoding Platform to
perform the entire
transcoding Transaction
in milliseconds. This
number is the duration
of the whole transaction
from the time it reached
the Transcoding
Platform to the time the
response was sent (it
can be higher or lower
the sum of durations for
all the Job Results).
TransactionJobResultThe Job Results. May
be more than one (one
per each Transcoding Job)
JobResultReturnCodeIntegerThe return code of the
Transcoding Job (either
a successful or a
warning)
JobResultMessageStringA message with an
explanation in case of a
warning
JobResultDurationIntegerThe duration it took this
Transcoding Job (in
milliseconds)
JobResultTargetDetails about the target.
TargetFileSizeIntegerThe actual size of the file
TargetLocationStringThe full-path on a
shared storage or the
Content ID of the
attachment.
TargetProfileIDStringThe Profile ID that was
used for this
Transcoding Job (in
case it was specified).
TargetTranscodingParamsThe Transcoding
Parameters of the target.
TranscodingParamsSizeLimitIntegerThe limit that was given
to the entire transaction
TranscodingParamsAudioAudio details
TranscodingParamsImageImage details
TranscodingParamsVideoVideo details
TranscodingParamsTextText details
TranscodingParamsCombinedMediaCombined-media details
TranscodingParamsTransformationA Transformation that
was applied (0 or more
appearances).
TransformationTypeStringAccording to theType of transformation
supported
Transformations
TransformationParameterStringAccording to theValue of parameter for
Supportedthis transformation
parameter values
for the specific
transformation
AudioFormatStringThe supportedThe file format
audio formats
AudioCodecStringThe supportedThe codec
audio codecs
AudioBitRateIntegerThe bit-rate
AudioSamplingRateIntegerThe sampling rate
AudioSamplingResolutionIntegerThe sampling resolution
AudioSizeLimitIntegerThe limit that was given
for an audio
AudioSyntheticOptionalSynthetic audio related
parameters.
SyntheticChannelToUseIntegerOptionalNumber of input channel
used in case the output
contains only one channel.
SyntheticChannelsPriorityStringOptionalA comma separated
permutation of 0-15. The
priority of the channels,
from the most important
to the least important.
SyntheticInstrumentIntegerOptionalThe instrument used,
when transcoding to
midi. Irrelevant for other
formats.
ImageFormatStringThe supportedThe format
image formats
ImageColorSchemeString“True24Bit”,The color scheme of the
“True12Bit”,image
“Palette256Co”,
“Palette256Gr”,
“Palette32Co”,
“Palette32Gr”,
“Palette16Co”,
“Pallete16Gr”,
“Palette4Co”,
“Palette4Gr”,
“1Bit”
ImageNunberOfColorsIntegerThe actual number of
colors
ImageWidthIntegerThe width
ImageHeightIntegerThe height
ImageSizeLimitIntegerThe limit that was given
for an image
VideoFormatStringThe supportedThe format
video formats
VideoCodecStringThe supportedThe codec
video codecs
VideoWidthIntegerThe width
VideoHeightIntegerThe height
VideoFrameRateIntegerThe frame rate
VideoBitRateIntegerThe bit rate
VideoSizeLimitIntegerThe limit that was given
for a video
CombinedMediaSizeLimitIntegerThe limit that was given
for a combined-media
CombinedMediaPresentationParamsParameters for the target
presentation
transcoding.
PresentationParamsFormatString“SMIL”,Target presentation
“HTML”,format
“None”
PresentationParamsTemplateStringTemplate for
presentation that was
used.
PresentationParamsLayoutString“Portrait”,Target layout.
“Landscape”
CombinedMediaEncodingString“Textual”,The encoding of the
“WAP”output MIME-Multipart.
|
A Transaction Failure response is returned in a situation where the whole Transaction could not be handled. This may happen if there was a problem with the Transaction parameters, or any other problem, which relates to the whole Transaction (and not only to one or more of the Transcoding Jobs). The header of a Transcoding error contains a line that indicates that there was an error (HTTP/1.1 500 Error), and the regular fields. The body of the SOAP, of a different structure from a successful one, is given in Table 4 below:
TABLE 4
|
|
ParentNameTypePossible valuesDescription
|
FaultResponseThe fault
FaultResponseTransactionIDIntegerThe unique ID that was
received from
the Application Platform in the
request
FaultResponseContextIDIntegerA unique ID of the
transcoding session
that is given by the
Transcoding platform
FaultResponseTotalDurationIntegerThe total milliseconds it took
the whole
Transaction to be handled
(until the error occurred)
FaultResponseReturnCodeIntegerOut of the possible
error codes
FaultResponseMessageStringAn explanatory error message
|
It may be added that the Transcoding Platform supports the Transaction error codes indicated in the following Table 5:
TABLE 5
|
|
Error codeError string
|
1001Parsing error
1004Erroneous target structure
1005Error in target data
1006General server error
1008No media detected in request message
1009Response composition error (<err-code>)
1010Number of concurrent requests exceeded the maximum
1011Erroneous transcoding request
1012Transaction result exceed maximal size
1013Policy could not be accomplished and transaction failed.
1014Policy could not be accomplished but transaction succeeded.
|
and that Transcoding Platform supports the Transcoding Job error codes indicated in the following Table 6:
TABLE 6
|
|
Error codeError string
|
2001Error in input media
2002Unsupported Content Type
2003Unsupported Content Format
2004Unsupported Content Codec
2005Unsupported Content
2006Unsupported transcoding request
2006Unsupported Transformation
2007No media detected in request message
2008Output content size exceeds the limit
2009Failed to read source content.
2010Failed to write target content.
2101DRM protected content: no transcoding done
|