ITU-T T 174-1996 Application Programming Interface (API) for MHEG-1 - Series T Terminals for Telematic Services (Study Group 8 325pp)《MHEG-1的应用编程接口(API) T系列 远程信息处理业务的终端 研究组8 235页》.pdf

1、 STD-ITU-T RECMN T.174-ENGL 179b W 48b257L Ob34Li2b b40 D INTERNATIONAL TELECOMMUNICATION UNION ITU=T TELECOMMUNICATION STANDARDIZATION SECTOR OF ITU T.174 (1 0196) SERIES T: TERMINALS FOR TELEMATIC SERVICES Application Programming Interface (API) for MHEG-I ITU-T Recommendation T. 174 (Previously C

2、CITT Recommendation) ITU-T T-SERIES RECOMMENDATIONS TERMINALS FOR TELEMATIC SERVICES For further details, please refer to ITU-T List of Recommendations. FOREWORD The ITU-T (Telecommunication Standardization Sector) is a permanent organ of the International Telecommunication Union (ITU). The ITU-T is

3、 responsible for studying technical, operating and tariff questions and issuing Recommen- dations on them with a view to standardizing telecommunications on a worldwide basis. The World Telecommunication Standardization Conference (WTSC), which meets every four years, establishes the topics for stud

4、y by the ITU-T Study Groups which, in their turn, produce Recommendations on these topics. The approval of Recommendations by the Members of the ITU-T is covered by the procedure laid down in WTSC Resolution No. 1 (Helsinki, March 1-12, 1993). IT-T Recommendation T.174 was prepared by ITU-T Study Gr

5、oup 8 (1993-1996) and was approved by the WTSC (Geneva, 9-18 October 1996). NOTE In this Recommendation, the expression “Administration“ is used for conciseness to indicate both a telecommunication administration and a recognized operating agency. O ITU 1997 All rights reserved. No part of this publ

6、ication may be reproduced or utilized in any form or by any means, electronic or mechanical, including photocopying and microfilm, without permission in writing from the ITU. Recommendation T.174 (10/96) i 1 2 3 4 5 6 7 11 CONTENTS Scope References Definitions and abbreviations . 3.1 Definitions 3.2

7、 Abbreviations Conformance 4.1 Implementation conformance . 4.1.1 Conformance requirements . 4.2 Application conformance 4.2.1 Strictly Conforming Application . 4.2.2 Conforming Application . 4 .i . 2 Conformance documentation 4.3 Test Methods . General description . 5.1 Functional reference model o

8、f MHEG using applications Reference model for multimedia applications . Functional specification of the MHEG-API . 5.2.1 MHEG usage specifications 5.2.1.1 Definitions . 5.2.1.2 MHEG objects . 5.2.1.3 Mh-objects . 5.2.1.4 Rt-objects 5.2.1.5 Channels 5.2.1.6 Interchanged MHEG objects . 5.1.1 5.1.2 The

9、 MHEG-API 5.2.2 Description of MHEG-related services . API definition principles Satisfaction of technical requirements on the MHEG-API . Comprehensive introduction to IDL . The Interface Definition Language . 6.2.2.1 Objects . 6.1 6.2 Use of Interface Definition Language (IDL) ISO/IEC 14750 lo . 6.

10、2.1 6.2.2 6.2.2.2 Requests 6.2.2.3 Types . 6.2.2.4 Interfaces . 6.2.2.5 Operations . 6.2.2.6 Attributes . 6.2.2.7 Subyping versus inheritance 6.2.2.8 Subtyping 6.2.2.9 Inheritance . . Principles for mapping IDL interfaces to API primitives Fulfilment of technical requirements Overview of the API def

11、inition and general principles The MHEG-API Object model 6.2.3 6.2.4 6.3.1 6.3 Definition of the MHEG-API . 7.1 Mandatory primitives 7.1.1 MHEGEngine object . 7.1.1 .i initialiseEngine operation 7.1.1.2 shutdownEngine operation 7.1.1.3 IDL description . Recommendation T.174 (10/96) Page 1 1 2 2 5 6

12、6 6 7 7 7 8 8 8 8 8 12 13 13 13 13 13 14 14 14 14 15 15 16 16 16 17 17 17 18 18 18 18 19 19 19 19 19 19 21 21 21 21 21 21 7.1.2 7.1.3 7.1.4 7.1.5 7.1.6 7.1.7 7.1.8 7.1.9 7.1.10 7.1.11 7.1.12 7.1.13 7.1.14 7.1.15 7.1.16 7.1.17 NotificationManager object 7.1.2.1 getRetumability operation . 7.1.2.2 get

13、Notification operation . 7.1.2.3 IDL description . EntityManager object 7.1.3.2 getAvailableRtObjects operation 7.1.3.3 getAvailableChannels operation 7.1.3.4 releaseAlias operation . . 7.1.3.5 IDL description . 7.1.4.1 setAlias operation 7.1 -4.3 JDL description . MhObject object 7.1 S.1 bind opera

14、tion . 7.1.5.2 unbind operation . 7.1.5.3 prepare operation . 7.1.5.5 getpreparationstatus operation 7.1 S.7 kill operation . . 7.1.5.8 IDL description . 7.1.6.1 delay operation 7.6.1.2 IDL description . 7.1.7.1 abort operation 7.1.8.1 IDL description . MhComponent object 7.1.9.1 IDL description . M

15、hGenericContent object . copy operation . MhContent object 7.1.1 1.1 setData operation . IDL description . MhMultipiexedContent object 7.1.12.2 setDemultiplex operation 7.1.13.1 IDL description . MhScript object MhContainer object . MhDescriptor object RtObjectOrSocket object . 7.1.17.1 setGlobalBeh

16、aviour operation . 7.1.17.2 getGlobalBehaviour operation 7.1.17.3 run operation 7.1.17.4 stop operation 7.1.3.1 getAvailableMhObjects operation . Entity object 7.1.4.2 getAlias operation . 7.1 S.4 destroy operation . 7.1.5.6 getIdentifier operation . MhAction object . MhLink object . 7.1.7.2 IDL des

17、cription . MhModel object 7.1.1 O . 1 7.1.10.2 IDL description . 7.1.1 1.2 getData operation 7.1 . 1 1.3 7.1.12.1 setMultiplex operation . 7 .i . 12.3 IDL description . MhComposite object . 7.1.14.1 IDL description . 7.1.15.1 IDL description . 7.1.16.1 IDL description . 7.1.17.5 IDL description . Re

18、commendation T.174 (10/96) Page 21 21 21 22 22 22 22 23 23 23 23 23 24 24 24 24 25 25 25 26 26 26 26 27 27 27 29 29 29 29 29 29 29 29 29 30 30 30 31 31 31 31 32 32 32 32 33 33 33 33 33 33 33 33 33 34 34 34 . 111 STD-ITU-T RECMN T.274-ENGL 1996 D 48b2.572 Ob34432 TUB D 7.1.18 RtObject object 7.1 .I 8

19、. 1 bind operation . 7.1.1 8.2 unbind operation . 7.1.18.3 new operation 7.1.18.4 delete operation . getAvailabilityStatus operation . 7.1.18.6 getIdentifier operation . 7.1.1 8.7 kill operation . 7.1.18.9 IDL description . bind operation . 7.1.19.2 unbind operation . 7.1 J9.3 getIdentifier operatio

20、n . 7.1.19.4 kill operation . 7.1 ,19.5 plug operation . 7.1.19.6 setVisibleDurationPosition operation 7.1.19.7 getVisibleDurationPosition operation . 7.1.19.8 IDL description . 7.1.20.1 setparameters operation . 7.1.20.2 getTerminationStatus operation 7.1.20.3 IDL description . 7.1.21 RtComponentOr

21、Socket object 7.1.2 1.1 setRGS operation . 7.1.21.2 getRGS operation 7.1.2 1.4 setpresentationpriority operation 7.1.21.6 getEffectiveOpacity operation . 7.1.2 1.8 setvisibleDuration operation . setCurrentTemporalPosition operation setspeed operation 7.1.21.12 setTimestones operation 7.1.2 1.13 getI

22、nitialTemporalPosition operation 7.1.2 1.14 getTerminalTemporalPosition operation . 7.1.2 1.15 getVDLength operation . 7.1.2 1.16 getTemporalTermination operation . 7.1.2 1.19 getOGTR operation . 7.1.2 1.20 getEffectiveSpeedRate operation 7.1.2 1.21 getEffectiveOGTR operation 7.1.2 1.22 getTimestone

23、Status operation . 7.1.2 1.24 setAspectRatio operation . 7.1.2 1.25 setVisibleSize operation 7.1.2 1.26 setVisibleSizesAdjustment operation 7.1.21.27 setBox operation 7.1.2 1.28 setDefaultBackground operation 7.1.2 1.29 setAttachmentPoint operation . 7.1.2 1.30 setAttachmentPointPosition operation .

24、 setVisibleSizesAlignment operation . 7.1.2 1.32 setMovingAbility operation . 7.1.2 1.33 setResizingAbility operation . 7.1.2 1.34 setScalingAbility operation . 7.1.21.35 setScrollingAbility operation 7.1 . 18.5 7.1 .I 8.8 getRunningStatus operation 7.1.19 Socket object . 7.1 . 19.1 7.1.20 RtScript

25、object . 7.1.2 1.3 setopacity operation 7.1.2 1.5 getopacity operation . 7.1.2 1.7 getpresentationpriority operation 7.1.2 1.9 setTemporalTermination operation . 7.1.2 1.1 O 7.1.2 1.1 1 7.1.2 1.17 getCurrentTemporalPosition operation . 7.1.2 1.18 getSpeedRate operation . 7.1.2 1.23 setPerceptibleSiz

26、eProjection operation . . 7.1.2 1.3 1 Page 35 35 35 35 36 36 36 37 37 37 38 38 38 38 38 39 39 39 40 40 40 41 41 41 41 42 42 42 43 43 43 44 44 45 45 46 46 46 47 47 47 48 48 48 49 49 49 50 50 51 51 52 52 53 53 54 54 55 55 iv Recommendation T.174 (10/96) 7.1.21.36 getGSR operation 7.1.21.37 getPS opera

27、tion . 7.1.21.38 getAspectRatio operation 7.1.21.39 getPSAP operation 7.1.21.40 getVSGS operation 7.1.21.41 getVS operation . 7.1.21.42 getBox operation . 7.1.2 1.43 getDefaultBackground operation 7.1.21.44 getVSIAP operation 7.1.2 1.45 getVSIAPPosition operation . 7.1.21.46 getVSEAP operation . 7.1

28、.2 1.47 getVSEAPPosition operation 7.1.21.49 getResizingAbility operation . 7.1.2 1 SO 7.1.21.48 getMovingAbility operation getScalingAbility operation . 7.1.21.5 1 getScrollingAbility operation 7.1.2 1.52 setselectability operation 7.1.2 1.55 getselectability operation 7.1.2 1.56 getEffectiveSelect

29、ability operation . 7.1.2 1.59 getSelectionPresentationEffectResponsibility operation . 7.1.2 1.60 setModifiability operation . 7.1.2 1.53 setSelectionStatus operation 7.1.2 1.54 setSelectionPresentationEffectResponsibility operation . 7.1.2 1.57 getselectionstatus operation . 7.1.21.58 getSeIection

30、Mode operation 7.1.21.61 setModificationStatus operation 7.1.2 1.62 setModificationPresentationEffectResponsibility operation . 7.1.2 1.63 getModifiability operation . 7.1.2 1.64 getEffectiveModifiability operation 7.1.21.65 getModificationStatus operation . 7.1.21.68 setNoInteractionSty1e operation

31、 7.1.21.66 getModificationMode operation 7.1.2 1.67 getModificationPresentationEffectResponsibility operation . 7.1.21.69 IDL description . 7.1.22 RtComponent object 7.1.22.1 IDL description . 7.1.23 RtCompositeOrStructuralSocket object 7.1.23.1 setResizingStrategy operation . 7.1.23.2 getResizingSt

32、rategy operation . 7.1.23.3 setAudibleCompositionEffect operation . 7.1.23.4 getAudibleCompositionEffect operation . 7.1.23.5 getNumberOSelectedSockets operation . 7.1.23.6 getNumberOfModifiedSockets operation . 7.1.23.7 setMenuInteractionStyle operation 7.1.23.8 setScrollingListInteractionSty le op

33、eration 7.1.23.9 IDL description . 7.1.24 RtComposite object . 7.1.24.1 IDL description . 7.1.25 StructuralSocket object . 7.1.25.1 IDL description . 7.1.26 RtGenericContentOrPresentableSocket object 7.1.26.1 setAudibleVolume operation . 7.1.26.2 getInitialOriginalAudibleVolume operation . 7.1.26.3

34、getCurrentOriginalAudibleVolume operation . 7.1.26.4 getEffectiveOriginalAudibleVolume operation 7.1.26.5 getPerceptibleAudibleVolume operation 7.1.26.6 setl3uttonInteractionStyle operation 7.1.26.7 IDL description . Recommendation T.174 (10/96) Page 55 56 56 56 57 57 57 58 58 58 59 59 60 60 60 61 6

35、1 61 62 62 63 63 63 64 64 65 65 65 66 66 66 67 67 67 73 73 73 73 73 74 74 74 75 75 76 77 77 78 78 78 78 78 78 79 79 79 80 81 V 7 .I . 27 7.1.28 7.1.29 7.1.30 7.1.31 7.1.32 7.1.33 7.1.34 7.1.35 7.1.36 7.1.37 RtGenericContent object . 7.1.27.1 IDL description . GenericPresentableSocket object 7.1.28.1

36、 IDL description . 7.1.29.1 setSliderInteractionStyie operation . 7.1.29.2 setEntryFieldInteractionStyle operation 7.1.29.3 IDL description . RtContentOrPresentableSocket object RtContent object 7.1.30.1 IDL description . Presentablesocket object . 7.1.3 1 . 1 IDL description . RtMultiplexedContentO

37、rPresentableSocket object . 7.1.32.2 getstreamchosen operation . RtMultipiexedContent object 7.1.33.1 IDL description . 7.1.34.1 IDL description . 7.1.3 5.1 bind operation . 7.1.35.3 new operation 7.1.35.5 getRtAvailabilityStatus operation . 7.1.35.7 kill operation . 7.1.35.8 setPerceptability opera

38、tion 7.1.35.9 getperceptability operation 7.1.35.1 1 IDL description . Parameter definition Exceptions . 7.1.37.1 InvalidTarget exception 7.1.37.2 InvalidParameter exception . 7.1.37.3 NotBound exception 7.1.37.4 AireadyBound exception . 7.1.37.5 IDL definition 7.1.32.1 setStreamChoice operation 7.1

39、.32.3 IDL description . MuItiplexedPresentableSocket object . Channel object . 7.1.35.2 unbind operation . 7.1.35.4 delete operation . 7.1.35.6 getIdentifier operation . 7.1.35.1 O getAssignedPerceptibles operation 7.2 Optional primitives . Annex A - Complete IDL definition of the MHEG API . Page 81

40、 81 81 81 81 82 82 83 83 83 83 83 83 84 84 84 85 85 85 85 85 85 85 86 86 87 87 87 87 88 88 88 89 105 105 105 105 105 105 105 105 vi Recommendation T.174 (10/96) STD*ITU-T RECMN T.174-ENGL 1996 4862571 Ob34434 717 SUMMARY This Recommendation specifies the abstract Application Programming Interface (A

41、PI) for the manipulation of multi- media and hypermedia information objects, Le. the API that shall be provided by MHEG engines for their control by MHEG applications. INTRODUCTION This Recommendation specifies the abstract Application Programming Interface (API) for the manipulation of multimedia a

42、nd hypermedia information objects, .e. the API that shall be provided by MHEG engines for their control by MHEG applications. This Recommendation is part of a broader standardisation framework that specifies the usage of MHEG so that interoperable equipments can be effectively developed to support m

43、ultimedia information services and applications. This implies: specifiing additional constraints to the use of MHEG objects within distributed systems and applications using telecommunication networks; defining APIS that building blocks of MHEG-using architectures should provide; defining MHEG profi

44、les complementing the MHEG-1 standard by specifying restrictions on the coded representation and speciQing the complete required behaviour of an MHEG engine that should be supported for a given category of applications and/or terminal equipments; defining an MHEG script interchange representation; d

45、efining end-to-end protocols for MHEG-using multimediahypermedia information services; specifying conformance testing procedures for these standards. - - - - - - Functional and technical requirements on this Recommendation have been described in ETR 225. Recommendation T.174 (10/96) vii - STD-ITU-T

46、RECMN T-174-ENGL L77b 4b2571 b14435 b53 m Recommendation T. 174 APPLICATION PROGRAMMING INTERFACE (API) FOR MHEG-1 (Geneva, 1996) 1 Scope MHEG Part 1 (ISO/IEC 13522-1 i) is a generic standard, which specifies the coded representation of interchanged multimediahypermedia information objects (MHEG obj

47、ects). These so-called MHEG objects are handled, interpreted and presented by MHEG engines. This Recommendation specifies the abstract Application Programming Interface (API) for the manipulation of multimedia and hypermedia information objects, Le. the API that shall be provided by MHEG engines for

48、 their control by MHEG applications. This API meets the following requirements: - - - it is independent of the programming language used for the MHEG application; it is independent of the underlying operating system; it is independent of the mechanism used for interchanging information between the A

49、PI user (i.e. MHEG application) and the API provider (i.e. MHEG engine), Le. the messages that are exchanged as the result of triggering API primitives; it is independent of the actual encoding of these messages; it is generic and meant to cover all application requirements; - - - it is conformance testable; - it aims to be as easy as possible to implement. 2 References The following ITU-T Recommendations and other references contain provisions which, through reference in this text, constitute provisions of this Recommendation. At the time of publication, the editions ind