1、- STD-ETSI ETS 300 777-2-ENGL 1998 m 3400855 0355882 TTb m ETS 300 777-2 December 1998 Source: MTA Reference: DE/MTA-011057-2 ICs: 33.020 Key words: API, MHEG, multimedia, terminal Terminal Equipment (TE); End-to-end protocols for multimedia information retrieval servi ces; Part 2: Use of Digital St
2、orage Media Command and Control (DSM-CC) for basic multimedia applications ETSI European Telecommunications Standards Institute ETSI Secretariat Postal address: F-O6921 Sophia Antipolis CEDEX - FRANCE Office address: 650 Route des Lucioles - Sophia Antipolis - Valbonne - FRANCE Internet: secretariat
3、 6 etsi.fr - hitp:/www.etsi.org Tel.: +334929442OO-Fax: +334936547 16 Copyright Notification: No part may be reproduced except as authorized by written permission. The copyright and the foregoing restriction extend to reproduction in all media. O European Telecommunications Standards Institute 1998.
4、 All rights reserved. STDmETSI ETS 300 777-2-ENGL 1994 3400855 0355883 932 Page 2 ETS 300 777-2: December 1998 Whilst every care has been taken in the preparation and publication of this document, errors in content, typographical or otherwise, may occur. If you have comments concerning its accuracy,
5、 please write to “ETSI Standards Making Support Dept.“ at the address shown on the title page. STDmETSI ETS 300 777-2-ENGL 1998 3400855 0355884 879 m Page 3 ETS 300 777-2: December 1998 Contents Foreword . 5 1 Scope 7 2 Normative references 7 3 Definitions and abbreviations 3.1 3.2 Abbreviations . 8
6、 4 Overview 8 The DAVIC application interchange format . 8 Core set of Java APIS 8 4.1 4.2 5.2 5.3 5.4 5.5 5.6 5.7 5.8 5.9 5.10 5.1 1 5.12 5.13 5.14 5.15 5.16 5.17 5.18 5.19 5.20 5.21 5.22 5.23 5.24 5.25 5.26 5.27 5.28 5.29 5.30 5 Package org.etsi.dsmccuu . 9 5.1 Class NameCom . . . . . . . . . . .
7、. . . . . . . . . . . . . . . . . . . Class Binding . 9 - Exception NOT-FOUND 9 Exception CANNOT-PROCEED . ._. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . , . . . . . . . . . . . . . . . . . . . . . . . . . 1 O Exception INV-NAME . . ., . . ._ ._ ._ 1 O Exception SERVICEXFR 10 Exceptio
8、n dsmccuuException _. . ._ _ _ _. . I 1 Exception INV-OFFSET 1 I 12 . 12 . 13 Exception NO-SUSPEND . 13 Exception MPEG-DELIVERY _. . . . . 13 Exception BAD-SCALE . . . . . _ . 13 Exception BAD-START _ _ _ ._ _. . . , 13 Exception BAD-STOP . . ., ._. _. _. . ,. ,. ,. . 14 Interface Base . Class File
9、. Class Directory ,. . Class Session. Class ServiceG Class First . 6 Example 23 History. . . . . , . . . . . . .2a Page 5 ETS 300 777-2: December 1998 Foreword This European Telecommunication Standard (ETS) has been produced by the Terminal Equipment (TE) Technical Committee and later the Multimedia
10、 Terminals and Applications (MTA) Project of the European Telecommunications Standards Institute (ETSI). This ETC consists of 4 parts as follows: Part 1: “Coding of multimedia and hypermedia information for basic multimedia applications (MHEG-5)“; Part 2: “Use of Digital Storage Media Command and Co
11、ntrol (DSM-CC) for basic multimedia applications“; “Application Programmable Interface (API) for MHEG-5“; “Videotex Enhanced Man Machine Interface (VEMMI) enhancements to support broadband muitimedia infomation retrieval services“. Part 3: Part 4: Transposition dates Date of adoption of this ETS: Da
12、te of latest announcement of this ETC (doa): 4 December 1998 31 March 1999 Date of latest publication of new National Standard or endorsement of this ETS (dop/e): 30 September I 999 Date of withdrawal of any conflicting National Standard (dow): 30 September I 999 STDUETS1 ETS 300 777-2-ENGL 1978 340
13、0855 035588b b41 = Page 7 ETS 300 777-2: December 1998 1 Scope This European Telecommunication Standard (ETS) specifies a profile of Digital Storage Media Command and Control (DSM-CC) for the use in basic multimedia applications. This ETS is applicable to Digital Audio Visual Council (DAVIC), versio
14、n 1.2, compliant systems. 2 Normative references This ETS incorporates by dated and undated reference, provisions from other publications. These references are cited at the appropriate places in the text and the publications are listed hereafter. For dated references, subsequent amendments to or rev
15、isions of any of these publications apply to this ETS only when incorporated in it by amendment or revision. For undated references the latest edition of the publication referred to applies. DAVIC 1.2 specifications. ISOAEC 1381 8-6 (1 996): “Information technology; Generic coding of moving pictures
16、 and associated audio information; Part 6: Extensions for DSM-CC“. ISOAEC 13522-5 (1 997): “Information technology; Coding of multimedia and hypermedia information; Part 5: Support for base-level interactive applications“. ISO/IEC 13522-6 (1 996): “Information technology; Coding of multimedia and hy
17、permedia information; Part 6: Support for enhanced interactive applications“. ETC 300 777-1 : “Terminal Equipment (TE); End-to-end protocols for multimedia information retrieval services; Part 1 : Coding of multimedia and hypermedia information for basic multimedia applications (MHEG-5)“. ETS 300 77
18、7-3: “Terminal Equipment (TE); End-to-end protocols for multimedia information retrieval services; Part 3: Application Programmable Interface (API) for MHEG-5“. Definitions and abbreviations Definitions For the purposes of this ETS, the definition of the standards referenced below apply. Should any
19、ambiguity occur, definitions of the following standards apply, in decreasing order: - ISOAEC 13818-6 (1996) Z; - DAVIC 1.2 specifications I. Application Programmable Interface (API): A boundaty across which a software application uses facilities of programming languages to invoke software services.
20、These facilities may include procedures or operations, shared data objects and resolution of identifiers. local application: A piece of software which is part of the (telecommunication) application and is running on the considered equipment. STD-ETSI ETS 300 777-2-ENGL 1998 3400855 0355887 588 m Pag
21、e 8 ETS 300 777-2: December 1998 3.2 Abbreviations For the purposes of this ETS, the following abbreviations apply: AP I ASN.l DAVIC DSM-CC MHEG SI STU VM Application Programming Interface Abstract Syntax Notation One Digital Audio Visual Council Digital Storage Media Command and Control Multimedia
22、and Hypermedia information coding Experts Group Service Information Set Top Unit Virtual Machine 4 Overview This clause positions the API defined by this ETS in the framework of the DAVIC 1.2 specifications l. 4.1 The DAVIC application interchange format To deliver multimedia information to Set Top
23、Units (STUs) in an interoperable way, applications shall use the Multimedia and Hypermedia information coding Experts Group (MHEGd) final form interchange format, as defined by ISO/IEC 13522-5 3. The ASN.l notation and encoding, as defined by ETS 300 777-1 5, shall be used to interchange MHEG-5 obje
24、cts. This format defines the semantics and the encoding of the multimedia and hypermedia objects. To deliver program code to STUs in an interoperable way, applications shall use the MHEG-5 InterchangedProgram class to encapsulate Java (note) Virtual Machine (VM) code, according to the semantics and
25、encoding defined by ISOAEC 13522-6 4. Java VM classes are called from MHEG-5 objects using the MHEG-5 Cali and Fork elementary actions. NOTE: Java is a trademark of Sun Microsystems, Inc. The Java VM code interchange unit is a Java VM class. Java VM classes shall be encoded as defined by the Class F
26、ile Format section of the Java Virtual Machine specification. A Java class encapsulates data and methods that consist of sequences of instructions. The instruction set is defined by the Java Virtual Machine instruction set section of the Java Virtual Machine specification. 4.2 Core set of Java APIS
27、The following set of APls are used by Java VM code in the DAVIC 1.2 specifications l to express access to basic functions of the STU in an interoperable way: - the java. lang package; - the java.utii package; - - - the org. is0 .mheg5 package; the org. etci. dsmccuu package; the org . etsi. dvbci pa
28、ckage. NOTE 1: The Java VM specification provides flexible mechanisms to call upon external functions whose interface is defined as a Java package. The DAVIC 1.2 specification l only includes a minimum core set of packages required for Java VM code to be useful in a DAVIC environment. It is anticipa
29、ted that additional Java packages will be standardized at a later stage. NOTE 2: Especially, the java.io package, although strictly speaking not necessary to the useful performance of the VM environment, is part of the Java foundation classes. It is intended that the java.io package be added to the
30、DAVIC core set of Java APls together with an adequate specification of its semantics in a DAVIC environment. The java. lang package, as defined by the Java API documentation, consists of the minimal set of Java VM classes needed to run Java VM code, supporting the following functionality: basic data
31、 types, object, mathematic operations, security, thread management, string manipulation, exception handling. STD-ETSI ETS 300 777-2-ENGL 1778 m 3400855 0355668 414 9 Page 9 ETS 300 777-2: December 1998 The java.utii package, as defined by the Java API documentation, consists o Java VM classes suppor
32、ting a number of utility features common to all Java VM programs. The org. is0 .mheg5 package, as defined by ETS 300 777-3 SI, provides Java VM code with access to and manipulation of the MHEG-5 multimedia presentation and interaction objects, .e. access to the dynamic attributes of MHEGd objects an
33、d invocation of elementary actions on MHEG-5 objects. The org.etsi.dsmccuu package enables Java VM code to use the DSM-CC User-to-User (U-U) interface objects for network data access. It gives access to the Core Consumer Client Application Portability Interface as defined by ISOAEC 13818-6 2. The or
34、g . etsi. dvbsi package enables Java VM code to access information transmitted in the DAVIC Service Information (SI) stream. 5 Package org.etsi.dsmccuu 5.1 Class NameComponent /* This class represents a name component composed of an id and a kind */ package .dsmcc.uu; public class NameComponent publ
35、ic java.lang.String id; public java.lang.String kind; 1 5.2 Class Binding /* This class represents a binding composed of a name and a type */ package .dsmcc.uu; public class Binding /* Possible values for the binding type */ public static final byte OBJECT = O; public static final byte NAMING-CONTEX
36、T = 1; public NameComponent name; public int type; 1 5.3 Exception NOT-FOUND /* This exception is thrown when a logical path name does not exist */ package .dsmcc.uu; public class NOTFOUND extends java.lang.Exception /* Possible values for the exception reason */ public static final byte MISSING-NOD
37、E = O; STD-ETSI ETS 300 777-2-ENGL 1998 = 3400855 0355889 350 Page 10 ETS 300 777-2: December 1998 public static final byte NOT-ANAMING-CONTEXT = 1; public static final byte NOT-AN-OBJECT = 2; public byte why; public NameComponent restOfName; 1 5.4 Exception CANNOT-PROCEED /* This exception is throw
38、n when a Directory does not have permission to resolve a node in a path name The caller may attempt to perform the resolve directly at the returned Directory */ package .dsmcc.uu; public class CANNOT-PROCEED extends java.lang.Exception public Directory directory; public NameComponent I restOfName; 1
39、 5.5 Exception INV-NAME /* This exception is thrown when a path name is incorrectly formatted */ package .dsmcc.uu; public class IW-NAME extends java.lang.Exception 1 5.6 Exception SERVICE-XFR I* This exception is thrown when a resolve operation was unsuccessful and provides an alternate Service Dom
40、ain when the requested Service can be resolved */ package .dsmcc.uu; public class SERVICE-XFR extends java.lang.Exception public byte ServiceDomain; public NameComponent 3 pathName; public byte initialcontext; 1 STD-ETSI ETS 300 777-2-ENGL 1998 = 3400855 0355870 072 Page 11 ETS 300 777-2: December 1
41、998 5.7 Exception dsmccuuException /* This exception is the superclass for a set of exceptions which return a minor reason and a completion status */ package .dsmcc.uu: public class dsmccuuException extends java.lang.Exception /* Possible values for the completion status */ public static final byte
42、YES = O: public static final byte NO = 1; public static final byte MAYBE = 2: public short minor: public short completed: I 5.8 Exception INV-OFFSET /* This exception is thrown when the offset is outside the range of a File content */ package .dsmcc.uu; public class INV-OFFSET dsmccuuException exten
43、ds I 5.9 Exception INV-SIZE /* This exception is thrown when the size exceeds server or network limits */ package .dsmcc.uu: public class INV-SIZE extends dsmccuuException 1 5.10 Exception READ-LOCKED /* This exception is thrown when reads are temporarily prevented for an object */ package .dsmcc.uu
44、; public class READ-LOCKED extends dsmccuuException 1 STDmETSI ETS 300 777-2-ENGL L998 3400855 0355891 TO9 W Page 12 ETS 300 777-2: December 1998 5.11 Exception WRITE-LOCKED /* This exception is thrown when writes are temporarily prevented for an object */ package .dsmcc.uu; public class WRITE-LOCKE
45、D extends dsmccuuException( I 5.12 Exception OPEN-LIMIT /* This exception is thrown when the number of active object references is the maximum allowed */ package .dsmcc.uu; public class OPEN-LIMIT dsmccuuException ( extends 1 5.13 Exception NO-AUTH /* This exception is thrown when the End-User has n
46、ot provided the correct authentication in the request */ package .dsmcc.uu; public class NO-ATH extends dsmccuuException( public byte authData: I 5.14 Exception UNK-USER /* This exception is thrown when the Principal End-User is unknown to the Service Domain */ package .dsmcc.uu; public class UNK-US
47、ER extends dsmccuuException 1 5.1 5 Exception BAD-COMPAT-INFO /* This exception is thrown in response to an operation which carries a DownloadInfoRequest with an unrecognized CompatibilityDescriptor */ package .dsmcc.uu; public class BAD-COMPAT-INFO extends dsmccuuException( I Page 13 ETS 300 777-2:
48、 December 1998 5.16 Exception NO-RESUME /* This exception is thrown when the previous application saved state cannot be recovered */ package .dsmcc.uu; public class NO-RESUME extends dsmccuuException 1 5.17 Exception NO-SUSPEND /* This exception is thrown when the object cannot save the application state */ package .dsmcc.uu: public class NO-SUSPEND dsmccuuException extends I 5.1 8 Exception MPEG-DELIVERY /* This exception is thrown when the Server is unable to deliver a mumtimedia object over an MP
