1、 UNION INTERNATIONALE DES TLCOMMUNICATIONS T.174 SECTEUR DE LA NORMALISATION DES TLCOMMUNICATIONS DE LUIT (10/96) SRIE T: TERMINAUX DES SERVICES TLMATIQUES Interface de programmation dapplication pour le systme MHEG-1 Recommandation UIT-T T.174 (Antrieurement Recommandation du CCITT) RECOMMANDATIONS
2、 UIT-T DE LA SRIE T TERMINAUX DES SERVICES TLMATIQUES Pour plus de dtails, voir la Liste des Recommandations de lUIT-T. Recommandation T.174 (10/96) i AVANT-PROPOS LUIT-T (Secteur de la normalisation des tlcommunications) est un organe permanent de lUnion internationale des tlcommunications (UIT). I
3、l est charg de ltude des questions techniques, dexploitation et de tarification, et met ce sujet des Recommandations en vue de la normalisation des tlcommunications lchelle mondiale. La Confrence mondiale de normalisation des tlcommunications (CMNT), qui se runit tous les quatre ans, dtermine les th
4、mes dtudes traiter par les Commissions dtudes de lUIT-T lesquelles laborent en retour des Recomman-dations sur ces thmes. Lapprobation des Recommandations par les Membres de lUIT-T seffectue selon la procdure dfinie dans la Rsolution n 1 de la CMNT (Helsinki, 1er-12 mars 1993). La Recommandation UIT
5、-T T.174, que lon doit la Commission dtudes 8 (1993-1996) de lUIT-T, a t approuve par la CMNT (Genve, 9-18 octobre 1996). _ NOTE Dans la prsente Recommandation, lexpression “Administration“ est utilise pour dsigner de faon abrge aussi bien une administration de tlcommunications quune exploitation re
6、connue de tlcommunications. UIT 1997 Droits de reproduction rservs. Aucune partie de cette publication ne peut tre reproduite ni utilise sous quelque forme que ce soit et par aucun procd, lectronique ou mcanique, y compris la photocopie et les microfilms, sans laccord crit de lUIT. ii Recommandation
7、 T.174 (10/96) TABLE DES MATIRES Page 1 Domaine dapplication 1 2 Rfrences normatives 1 3 Dfinitions et abrviations 2 3.1 Dfinitions. 2 3.2 Abrviations 5 4 Conformit 6 4.1 Conformit dimplmentation 6 4.1.1 Exigences de conformit . 6 4.1.2 Documentation de conformit . 7 4.2 Conformit dapplication. 7 4.
8、2.1 Application strictement conforme . 7 4.2.2 Application conforme 8 4.3 Mthodes de test . 8 5 Description gnrale. 8 5.1 Modle de rfrence fonctionnel des applications utilisant le systme MHEG. 8 5.1.1 Modle de rfrence pour les applications multimdias 8 5.1.2 Linterface API MHEG 13 5.2 Spcifications
9、 fonctionnelles de linterface API MHEG . 14 5.2.1 Spcifications dutilisation du systme MHEG 14 5.2.1.1 Dfinitions. 14 5.2.1.2 Objets MHEG 14 5.2.1.3 mh-objets. 14 5.2.1.4 rt-objets (objets dexcution) . 15 5.2.1.5 Canaux. 15 5.2.1.6 Objets MHEG changs 15 5.2.2 Description de services en relation avec
10、 la norme MHEG 15 6 Principes de dfinition de linterface API . 16 6.1 Satisfaction aux exigences techniques de linterface API MHEG . 16 6.2 Utilisation du langage de dfinition dinterface (IDL) ISO/CEI 14750 10 . 17 6.2.1 Introduction complte au langage IDL 17 6.2.2 Le langage de dfinition dinterface
11、. 17 6.2.2.1 Objets 18 6.2.2.2 Demandes 18 6.2.2.3 Types. 18 6.2.2.4 Interfaces. 19 6.2.2.5 Oprations . 19 6.2.2.6 Attributs. 19 6.2.2.7 Comparaison entre sous-types et hritage . 19 6.2.2.8 Sous-types . 20 6.2.2.9 Hritage. 20 6.2.3 Principes de meppefe des interfaces IDL avec les primitives API 20 6
12、.2.4 Satisfaction aux exigences techniques. 20 6.3 Aperu gnral de la dfinition de linterface API et principes gnraux 20 6.3.1 Le modle objet de linterface API MHEG . 20 7 Dfinition de linterface API MHEG 22 7.1 Primitives obligatoires 22 7.1.1 Objet MHEGEngine 22 7.1.1.1 Opration initialiseEngine. 2
13、2 7.1.1.2 Opration shutdownEngine . 22 7.1.1.3 Description IDL. 22 Recommandation T.174 (10/96) iii Page 7.1.2 Objet NotificationManager 22 7.1.2.1 Opration getReturnability 22 7.1.2.2 Opration getNotification 22 7.1.2.3 Description IDL. 23 7.1.3 Objet EntityManager . 23 7.1.3.1 Opration getAvailabl
14、eMhObjects 23 7.1.3.2 Opration getAvailableRtObjects 23 7.1.3.3 Opration getAvailableChannels. 24 7.1.3.4 Opration releaseAlias 24 7.1.3.5 Description IDL. 24 7.1.4 Objet Entity . 24 7.1.4.1 Opration setAlias . 24 7.1.4.2 Opration getAlias. 25 7.1.4.3 Description IDL. 25 7.1.5 Objet MhObject. 25 7.1
15、.5.1 Opration bind. 25 7.1.5.2 Opration unbind. 26 7.1.5.3 Opration prepare 26 7.1.5.4 Opration destroy 26 7.1.5.5 Opration getPreparationStatus. 27 7.1.5.6 Opration getIdentifier 27 7.1.5.7 Opration kill 27 7.1.5.8 Description IDL. 27 7.1.6 Objet MhAction. 27 7.1.6.1 Opration delay . 28 7.1.6.2 Des
16、cription IDL. 28 7.1.7 Objet MhLink. 29 7.1.7.1 Opration abort 29 7.1.7.2 Description IDL. 29 7.1.8 Objet MhModel. 29 7.1.8.1 Description IDL. 29 7.1.9 Objet MhComponent. 29 7.1.9.1 Description IDL. 29 7.1.10 Objet MhGenericContent 29 7.1.10.1 Opration copy 29 7.1.10.2 Description IDL. 30 7.1.11 Obj
17、et MhContent. 30 7.1.11.1 Opration setData 30 7.1.11.2 Opration getData . 31 7.1.11.3 Description IDL. 31 7.1.12 Objet MhMultiplexedContent . 31 7.1.12.1 Opration setMultiplex 31 7.1.12.2 Opration setDemultiplex 32 7.1.12.3 Description IDL. 32 7.1.13 Objet MhComposite 32 7.1.13.1 Description IDL. 32
18、 7.1.14 Objet MhScript 33 7.1.14.1 Description IDL. 33 7.1.15 Objet MhContainer 33 7.1.15.1 Description IDL. 33 7.1.16 Objet MhDescriptor 33 7.1.16.1 Description IDL. 33 7.1.17 Objet RtObjectOrSocket . 33 7.1.17.1 Opration setGlobalBehaviour 33 7.1.17.2 Opration getGlobalBehaviour 33 7.1.17.3 Oprati
19、on run 34 7.1.17.4 Opration stop . 34 7.1.17.5 Description IDL. 34 iv Recommandation T.174 (10/96) Page 7.1.18 Objet RtObject 35 7.1.18.1 Opration bind. 35 7.1.18.2 Opration unbind. 35 7.1.18.3 Opration new . 35 7.1.18.4 Opration delete 36 7.1.18.5 Opration getAvailabilityStatus. 36 7.1.18.6 Opratio
20、n getIdentifier 36 7.1.18.7 Opration kill 37 7.1.18.8 Opration getRunningStatus 37 7.1.18.9 Description IDL. 37 7.1.19 Objet Socket 38 7.1.19.1 Opration bind. 38 7.1.19.2 Opration unbind. 38 7.1.19.3 Opration getIdentifier 38 7.1.19.4 Opration kill 38 7.1.19.5 Opration plug. 39 7.1.19.6 Opration set
21、VisibleDurationPosition. 39 7.1.19.7 Opration getVisibleDurationPosition 39 7.1.19.8 Description IDL. 40 7.1.20 Objet RtScript 40 7.1.20.1 Opration setParameters 40 7.1.20.2 Opration getTerminationStatus 41 7.1.20.3 Description IDL. 41 7.1.21 Objet RtComponentOrSocket 41 7.1.21.1 Opration setRGS 41
22、7.1.21.2 Opration getRGS . 42 7.1.21.3 Opration setOpacity. 42 7.1.21.4 Opration setPresentationPriority 42 7.1.21.5 Opration getOpacity 43 7.1.21.6 Opration getEffectiveOpacity 43 7.1.21.7 Opration getPresentationPriority . 43 7.1.21.8 Opration setVisibleDuration 44 7.1.21.9 Opration setTemporalTer
23、mination 44 7.1.21.10 Opration setCurrentTemporalPosition. 45 7.1.21.11 Opration setSpeed 45 7.1.21.12 Opration setTimestones . 46 7.1.21.13 Opration getInitialTemporalPosition. 46 7.1.21.14 Opration getTerminalTemporalPosition 46 7.1.21.15 Opration getVDLength 47 7.1.21.16 Opration getTemporalTermi
24、nation 47 7.1.21.17 Opration getCurrentTemporalPosition 47 7.1.21.18 Opration getSpeedRate 48 7.1.21.19 Opration getOGTR 48 7.1.21.20 Opration getEffectiveSpeedRate 48 7.1.21.21 Opration getEffectiveOGTR 49 7.1.21.22 Opration getTimestoneStatus. 49 7.1.21.23 Opration setPerceptibleSizeProjection 49
25、7.1.21.24 Opration setAspectRatio 50 7.1.21.25 Opration setVisibleSize . 50 7.1.21.26 Opration setVisibleSizesAdjustment . 51 7.1.21.27 Opration setBox. 51 7.1.21.28 Opration setDefaultBackground 52 7.1.21.29 Opration setAttachmentPoint. 52 7.1.21.30 Opration setAttachmentPointPosition 53 7.1.21.31
26、Opration setVisibleSizesAlignment. 53 7.1.21.32 Opration setMovingAbility 54 7.1.21.33 Opration setResizingAbility 54 7.1.21.34 Opration setScalingAbility 55 7.1.21.35 Opration setScrollingAbility 55 Recommandation T.174 (10/96) v Page 7.1.21.36 Opration getGSR . 55 7.1.21.37 Opration getPS 56 7.1.2
27、1.38 Opration getAspectRatio . 56 7.1.21.39 Opration getPSAP . 56 7.1.21.40 Opration getVSGS. 57 7.1.21.41 Opration getVS 57 7.1.21.42 Opration getBox 57 7.1.21.43 Opration getDefaultBackground 58 7.1.21.44 Opration getVSIAP . 58 7.1.21.45 Opration getVSIAPPosition 58 7.1.21.46 Opration getVSEAP 59
28、7.1.21.47 Opration getVSEAPPosition . 59 7.1.21.48 Opration getMovingAbility . 60 7.1.21.49 Opration getResizingAbility 60 7.1.21.50 Opration getScalingAbility 60 7.1.21.51 Opration getScrollingAbility . 61 7.1.21.52 Opration setSelectability 61 7.1.21.53 Opration setSelectionStatus. 61 7.1.21.54 Op
29、ration setSelectionPresentationEffectResponsibility. 62 7.1.21.55 Opration getSelectability . 62 7.1.21.56 Opration getEffectiveSelectability. 63 7.1.21.57 Opration getSelectionStatus. 63 7.1.21.58 Opration getSelectionMode. 63 7.1.21.59 Opration getSelectionPresentationEffectResponsibility 64 7.1.2
30、1.60 Opration setModifiability 64 7.1.21.61 Opration setModificationStatus . 65 7.1.21.62 Opration setModificationPresentationEffectResponsibility. 65 7.1.21.63 Opration getModifiability 65 7.1.21.64 Opration getEffectiveModifiability . 66 7.1.21.65 Opration getModificationStatus. 66 7.1.21.66 Oprat
31、ion getModificationMode. 66 7.1.21.67 Opration getModificationPresentationEffectResponsibility 67 7.1.21.68 Opration setNoInteractionStyle . 67 7.1.21.69 Description IDL. 67 7.1.22 Objet RtComponent. 73 7.1.22.1 Description IDL. 73 7.1.23 Objet RtCompositeOrStructuralSocket . 73 7.1.23.1 Opration se
32、tResizingStrategy 73 7.1.23.2 Opration getResizingStrategy 73 7.1.23.3 Opration setAudibleCompositionEffect. 74 7.1.23.4 Opration getAudibleCompositionEffect 74 7.1.23.5 Opration getNumberOfSelectedSockets 74 7.1.23.6 Opration getNumberOfModifiedSockets. 75 7.1.23.7 Opration setMenuInteractionStyle.
33、 75 7.1.23.8 Opration setScrollingListInteractionStyle 76 7.1.23.9 Description IDL. 77 7.1.24 Objet RtComposite 77 7.1.24.1 Description IDL. 78 7.1.25 Objet StructuralSocket 78 7.1.25.1 Description IDL. 78 7.1.26 Objet RtGenericContentOrPresentableSocket. 78 7.1.26.1 Opration setAudibleVolume 78 7.1
34、.26.2 Opration getInitialOriginalAudibleVolume. 78 7.1.26.3 Opration getCurrentOriginalAudibleVolume 79 7.1.26.4 Opration getEffectiveOriginalAudibleVolume 79 7.1.26.5 Opration getPerceptibleAudibleVolume 79 7.1.26.6 Opration setButtonInteractionStyle . 80 7.1.26.7 Description IDL. 81 vi Recommandat
35、ion T.174 (10/96) Page 7.1.27 Objet RtGenericContent 81 7.1.27.1 Description IDL. 81 7.1.28 Objet GenericPresentableSocket . 81 7.1.28.1 Description IDL. 81 7.1.29 Objet RtContentOrPresentableSocket . 81 7.1.29.1 Opration setSliderInteractionStyle. 82 7.1.29.2 Opration setEntryFieldInteractionStyle
36、. 82 7.1.29.3 Description IDL. 83 7.1.30 Objet RtContent. 83 7.1.30.1 Description IDL. 83 7.1.31 Objet PresentableSocket 83 7.1.31.1 Description IDL. 83 7.1.32 Objet RtMultiplexedContentOrPresentableSocket 83 7.1.32.1 Opration setStreamChoice. 84 7.1.32.2 Opration getStreamChosen 84 7.1.32.3 Descrip
37、tion IDL. 84 7.1.33 Objet RtMultiplexedContent . 85 7.1.33.1 Description IDL. 85 7.1.34 Objet MultiplexedPresentableSocket 85 7.1.34.1 Description IDL. 85 7.1.35 Objet Channel 85 7.1.35.1 Opration bind. 85 7.1.35.2 Opration unbind. 85 7.1.35.3 Opration new . 86 7.1.35.4 Opration delete 86 7.1.35.5 O
38、pration getRtAvailabilityStatus. 87 7.1.35.6 Opration getIdentifier 87 7.1.35.7 Opration kill 87 7.1.35.8 Opration setPerceptability . 87 7.1.35.9 Opration getPerceptability. 88 7.1.35.10 Opration getAssignedPerceptibles. 88 7.1.35.11 Description IDL. 88 7.1.36 Dfinition de paramtre. 89 7.1.37 Excep
39、tions. 105 7.1.37.1 Exception InvalidTarget 105 7.1.37.2 Exception InvalidParameter 105 7.1.37.3 Exception NotBound. 105 7.1.37.4 Exception AlreadyBound 105 7.1.37.5 Dfinition IDL. 105 7.2 Primitives optionnelles 106 Annexe A Dfinition IDL complte de linterface de programmation dapplication MHEG 106
40、 Recommandation T.174 (10/96) vii RSUM La prsente Recommandation spcifie linterface abstraite de programmation dapplication (API, application programming interface) pour la manipulation dobjets dinformation multimdia et hypermdia, cest-dire linterface API qui sera fournie par les moteurs MHEG en vue
41、 de leur pilotage par des applications MHEG. INTRODUCTION La prsente Recommandation spcifie linterface abstraite de programmation dapplication (API) pour la manipulation dobjets dinformation multimdia et hypermdia, cest-dire linterface API qui sera fournie par les moteurs MHEG en vue de leur pilotag
42、e par des applications MHEG. La prsente Recommandation entre dans un cadre de normalisation plus large qui spcifie lutilisation de la norme MHEG, dont le but est de permettre la ralisation efficace dquipements interoprables prenant en charge des services dinformation et dapplications multimdias. Cec
43、i implique: la spcification de contraintes supplmentaires pour lutilisation des objets MHEG au sein de systmes et dapplications rparties utilisant des rseaux de tlcommunication; la dfinition dinterfaces API devant tre fournie par des architectures de blocs de construction dapplications MHEG; la dfin
44、ition de profils MHEG venant complter la norme MHEG-1 en spcifiant les limitations concernant les reprsentations codes et en spcifiant compltement le comportement exig dun moteur MHEG qui doit tre pris en charge pour une catgorie donne dapplications et/ou dquipements terminaux; la dfinition dune rep
45、rsentation pour un script dchange MHEG; la dfinition de protocoles de bout en bout pour une application MHEG utilisant des services dinformation multimdia/hypermdia; la spcification de procdures de test de conformit pour ces normes. Les prescriptions fonctionnelles et techniques pour la prsente Reco
46、mmandation ont t dcrites dans le rapport ETR 225. Recommandation T.174 (10/96) 1 Recommandation T.174 Recommandation T.174 (10/96) INTERFACE DE PROGRAMMATION DAPPLICATION POUR LE SYSTME MHEG-1 (Genve, 1996) 1 Domaine dapplication La Partie 1 de la norme MHEG (ISO/CEI 13522-1 1) est une norme gnrique
47、 qui spcifie la reprsentation code des objets dinformation multimdia/hypermdia (objets MHEG) qui sont changs. Ces objets, appels objets MHEG, sont traits, interprts et prsents par des moteurs MHEG. La prsente Recommandation spcifie linterface abstraite de programmation dapplication (API, application
48、 programming interface) pour la manipulation dobjets dinformation multimdia et hypermdia, cest-dire linterface API qui sera fournie par les moteurs MHEG en vue de leur pilotage par des applications MHEG. Cette interface API obit aux exigences suivantes: elle est indpendante du langage de programmation utilis pour lapplication MHEG; elle est indpendante du systme dex