ETSI TS 103 544-15-2017 Publicly Available Specification (PAS) Intelligent Transport Systems (ITS) MirrorLink Part 15 Application Programming Interface (API) Level 1 & 2 (V1 3 0).pdf

1、 ETSI TS 103 544-15 V1.3.0 (2017-10) Publicly Available Specification (PAS); Intelligent Transport Systems (ITS); MirrorLink; Part 15: Application Programming Interface (API) Level 1 Essential, or potentially Essential, IPRs notified to ETSI in respect of ETSI standards“, which is available from the

2、 ETSI Secretariat. Latest updates are available on the ETSI Web server (https:/ipr.etsi.org/). Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or th

3、e updates on the ETSI Web server) which are, or may be, or may become, essential to the present document. Trademarks The present document may include trademarks and/or tradenames which are asserted and/or registered by their owners. ETSI claims no ownership of these except for any which are indicate

4、d as being the property of ETSI, and conveys no right to use or reproduce any trademark and/or tradename. Mention of those trademarks in the present document does not constitute an endorsement by ETSI of products, services or organizations associated with those trademarks. Foreword This Technical Sp

5、ecification (TS) has been produced by ETSI Technical Committee Intelligent Transport Systems (ITS). The present document is part 15 of a multi-part deliverable. Full details of the entire series can be found in part 1 i.1. Modal verbs terminology In the present document “shall“, “shall not“, “should

6、“, “should not“, “may“, “need not“, “will“, “will not“, “can“ and “cannot“ are to be interpreted as described in clause 3.2 of the ETSI Drafting Rules (Verbal forms for the expression of provisions). “must“ and “must not“ are NOT allowed in ETSI deliverables except when used in direct citation. ETSI

7、 ETSI TS 103 544-15 V1.3.0 (2017-10)7 1 Scope The present document is part of the MirrorLinkspecification which specifies an interface for enabling remote user interaction of a mobile device via another device. The present document is written having a vehicle head-unit to interact with the mobile de

8、vice in mind, but it will similarly apply for other devices, which provide a colour display, audio input/output and user input mechanisms. The MirrorLink API specifies an interface to the MirrorLink Server, which allows any application to either get information about MirrorLink Servers or Clients pr

9、operties or to set them to specific values. In addition, the API specifies callback functions, which are used from the MirrorLink Server to inform the application about any change. 2 References 2.1 Normative references References are either specific (identified by date of publication and/or edition

10、number or version number) or non-specific. For specific references, only the cited version applies. For non-specific references, the latest version of the referenced document (including any amendments) applies. Referenced documents which are not found to be publicly available in the expected locatio

11、n might be found at https:/docbox.etsi.org/Reference. NOTE: While any hyperlinks included in this clause were valid at the time of publication, ETSI cannot guarantee their long-term validity. The following referenced documents are necessary for the application of the present document. 1 W3C: “JSpeec

12、h Grammar Format“, available at https:/www.w3.org/TR/jsgf/. 2 ETSI TS 103 544-22 (V1.3.0): “Publicly Available Specification (PAS); Intelligent Transport Systems (ITS); MirrorLink; Part 22: Android Specific Specifications enabling AIDL-based MirrorLink Applications“. 3 IETF RFC 2397: The “data“ URL

13、scheme, August 1998, http:/tools.ietf.org/html/rfc2397 . 2.2 Informative references References are either specific (identified by date of publication and/or edition number or version number) or non-specific. For specific references, only the cited version applies. For non-specific references, the la

14、test version of the referenced document (including any amendments) applies. NOTE: While any hyperlinks included in this clause were valid at the time of publication, ETSI cannot guarantee their long-term validity. The following referenced documents are not necessary for the application of the presen

15、t document but they assist the user with regard to a particular subject area. i.1 ETSI TS 103 544-1 (V1.3.0): “Publicly Available Specification (PAS); Intelligent Transport Systems (ITS); MirrorLink; Part 1: Connectivity“. 3 Abbreviations For the purposes of the present document, the following abbre

16、viations apply: ACMS Application Certification Management System BT Bluetooth ML MirrorLink ETSI ETSI TS 103 544-15 V1.3.0 (2017-10)8 OCSP Online Certificate Status Protocol RFB Remote Framebuffer UPnP Universal Plug and Play USB Universal Serial Bus VNC Virtual Network Computing 4 Introduction The

17、MirrorLink API specifies an interface to the MirrorLink Server, which allows any application to either get information about MirrorLink Servers or Clients properties or to set them to specific values. In addition, the API specifies callback functions, which are used from the MirrorLink Server to inf

18、orm the application about any change. Callback functions shall be implemented from the applications for any evented function. The MirrorLink APIs define a baseline API that shall be made accessible to 3rdparty app developers and does in no way restrict private APIs that can be developed by a MirrorL

19、ink Server vendor to satisfy his proprietary needs. The MirrorLink API specifies the interface in a platform/OS independent manner. Platform specific specification will describe the detailed platform specific view of the MirrorLink API, which shall be implemented from any MirrorLink Server device. T

20、he platform specific implementation of the MirrorLink API shall provide method to implement the features specified in this document, with at least the values provided in the present document. A specific API function can be marked as Mandatory or Optional. Any Mandatory marked function shall be fully

21、 implemented from the MirrorLink Server. Any Optional marked function should be fully implemented from the MirrorLink Server. In case the function is not fully implemented, the MirrorLink Server shall implement an empty shell, which responds with defined default values and a success flag set to “Fal

22、se“ (if available). The MirrorLink API specifies functions with three types of API functions: Get: The function is providing read access to information available on the MirrorLink Server. Set: The function is providing write access to information available on the MirrorLink Server. Callback: The fun

23、ction is a callback function, invoked from the MirrorLink Server. The implementation of the callback functionality will be specified in the platform specific specifications. All three functions may have a Success return value specified. The return value is set to True, if the action has been success

24、ful or the information requested is available. Otherwise the return value is set to False. Some of the data provided via the MirrorLink API will not be available from MirrorLink 1.0 clients. In such case, the MirrorLink Server shall provide a default value as specified. The MirrorLink API uses a set

25、 of Data Types, given in table 1. The platform specific API may use other data types, as long as the original intend of the MirrorLink API is not compromised. Therefore, the platform specific implementation of the MirrorLink API may use existing platform APIs are sub-classed versions of them. Table

26、1: Data Types and Default Values g24g258g410g258g3g100g455g393g286g3 g24g286g400g272g396g349g393g410g349g381g374g3g271g381g381g367g3g24g258g410g258g3g410g455g393g286g3g396g286g393g396g286g400g286g374g410g349g374g336g3g410g346g286g3g367g381g336g349g272g258g367g3g448g258g367g437g286g400g3g410g396g437g

27、286g3g258g374g282g3g296g258g367g400g286g856g3g3g100g346g286g3g396g286g393g396g286g400g286g374g410g258g410g349g381g374g3g381g296g3g296g258g367g400g286g3g349g400g3g258g367g367g882g271g349g410g400g882g460g286g396g381g853g3g258g374g282g3g410g346g286g3g396g286g393g396g286g400g286g374g410g258g410g349g381g

28、374g3g381g296g3g410g396g437g286g3g349g400g3g437g374g400g393g286g272g349g296g349g286g282g3g286g454g272g286g393g410g3g410g346g258g410g3g349g410g3g400g346g258g367g367g3g346g258g448g286g3g258g410g3g367g286g258g400g410g3g381g374g286g3g271g349g410g3g400g286g410g856g3g24g286g296g258g437g367g410g855g3g38g4g

29、62g94g28g3g437g349g374g410g1012g3g24g258g410g258g3g410g455g393g286g3g396g286g393g396g286g400g286g374g410g349g374g336g3g349g374g410g286g336g286g396g3g448g258g367g437g286g400g3g396g258g374g336g349g374g336g3g296g396g381g373g3g1004g3g410g381g3g393g381g400g349g410g349g448g286g3g1006g1009g1009g3g894g1004g

30、454g38g38g895g3g24g286g296g258g437g367g410g855g3g1004g3g437g349g374g410g1005g1010g3 g24g258g410g258g3g410g455g393g286g3g396g286g393g396g286g400g286g374g410g349g374g336g3g349g374g410g286g336g286g396g3g448g258g367g437g286g400g3g396g258g374g336g349g374g336g3g296g396g381g373g3g1004g3g410g381g3g393g381g4

31、00g349g410g349g448g286g3g1010g1009g853g1009g1007g1009g3g894g1004g454g38g38g38g38g895g3ETSI ETSI TS 103 544-15 V1.3.0 (2017-10)9 g24g258g410g258g3g100g455g393g286g3 g24g286g400g272g396g349g393g410g349g381g374g3g24g286g296g258g437g367g410g855g3g1004g3g437g349g374g410g1007g1006g3g24g258g410g258g3g410g4

32、55g393g286g3g396g286g393g396g286g400g286g374g410g349g374g336g3g349g374g410g286g336g286g396g3g448g258g367g437g286g400g3g396g258g374g336g349g374g336g3g296g396g381g373g3g1004g3g410g381g3g393g381g400g349g410g349g448g286g3g1008g853g1006g1013g1008g853g1013g1010g1011g853g1006g1013g1009g3g894g1004g454g38g38

33、g38g38g38g38g38g38g895g3g24g286g296g258g437g367g410g855g3g1004g3g349g374g410g1012g3g24g258g410g258g3g410g455g393g286g3g396g286g393g396g286g400g286g374g410g349g374g336g3g349g374g410g286g336g286g396g3g448g258g367g437g286g400g3g396g258g374g336g349g374g336g3g296g396g381g373g3g374g286g336g258g410g349g448

34、g286g3g1005g1006g1012g3g894g1004g454g1012g1004g895g3g410g381g3g393g381g400g349g410g349g448g286g3g1005g1006g1011g3g894g1004g454g1011g38g895g3g24g286g296g258g437g367g410g855g3g1004g3g349g374g410g1005g1010g3g24g258g410g258g3g410g455g393g286g3g396g286g393g396g286g400g286g374g410g349g374g336g3g349g374g41

35、0g286g336g286g396g3g448g258g367g437g286g400g3g396g258g374g336g349g374g336g3g296g396g381g373g3g374g286g336g258g410g349g448g286g3g1007g1006g853g1011g1010g1012g3g894g1004g454g1012g1004g1004g1004g895g3g410g381g3g393g381g400g349g410g349g448g286g3g1007g1006g853g1011g1010g1011g3g894g1004g454g1011g38g38g38g

36、895g3g24g286g296g258g437g367g410g855g3g1004g3g349g374g410g1007g1006g3g24g258g410g258g3g410g455g393g286g3g396g286g393g396g286g400g286g374g410g349g374g336g3g258g374g3g349g374g410g286g336g286g396g3g448g258g367g437g286g400g3g396g258g374g336g349g374g336g3g296g396g381g373g3g374g286g336g258g410g349g448g286

37、g3g1006g853g1005g1008g1011g853g1008g1012g1007g853g1010g1008g1012g3g894g1004g454g1012g1004g1004g1004g1004g1004g1004g1004g895g3g410g381g3g393g381g400g349g410g349g448g286g3g1006g853g1005g1008g1011g853g1008g1012g1007g853g1010g1008g1011g3g894g1004g454g1011g38g38g38g38g38g38g38g895g3g24g286g296g258g437g36

38、7g410g855g3g1004g3g296g367g381g258g410g3g24g258g410g258g3g410g455g393g286g3g396g286g393g396g286g400g286g374g410g349g374g336g3g258g3g1007g1006g882g271g349g410g3g296g367g381g258g410g349g374g336g3g393g381g349g374g410g3g448g258g367g437g286g3g258g272g272g381g396g282g349g374g336g3g47g28g28g28g1011g1009g10

39、08g882g1005g1013g1012g1009g853g3g400g349g374g336g367g286g882g393g396g286g272g349g400g349g381g374g3g24g286g296g258g437g367g410g855g3g1004g856g1004g3g282g381g437g271g367g286g3g24g258g410g258g3g410g455g393g286g3g396g286g393g396g286g400g286g374g410g349g374g336g3g258g3g1010g1008g882g271g349g410g3g296g367

40、g381g258g410g349g374g336g3g393g381g349g374g410g3g448g258g367g437g286g3g258g272g272g381g396g282g349g374g336g3g47g28g28g28g1011g1009g1008g882g1005g1013g1012g1009g853g3g282g381g437g271g367g286g882g393g396g286g272g349g400g349g381g374g3g24g286g296g258g437g367g410g855g3g1004g856g1004g3g400g410g396g349g374

41、g336g1012g3g4g396g396g258g455g3g381g296g3g104g100g38g1012g3g272g346g258g396g258g272g410g286g396g400g856g3g28g258g272g346g3g272g346g258g396g258g272g410g286g396g3g410g258g364g286g400g3g1005g3g271g455g410g286g3g894g104g100g38g1012g895g856g3g24g286g296g258g437g367g410g855g3“g3g400g410g396g349g374g336g10

42、05g1010g3g4g396g396g258g455g3g381g296g3g104g100g38g1005g1010g3g272g346g258g396g258g272g410g286g396g400g856g3g28g258g272g346g3g272g346g258g396g258g272g410g286g396g3g410g258g364g286g400g3g1006g3g271g455g410g286g400g3g894g104g100g38g1005g1010g895g856g3g24g286g296g258g437g367g410g855g3“g3g437g396g367g3g

43、24g258g410g258g3g410g455g393g286g3g396g286g393g396g286g400g286g374g410g349g374g336g3g258g3g104g90g62g3g24g286g296g258g437g367g410g855g3“g3g410g455g393g286g69g258g373g286g896g897g3g24g258g410g258g3g410g455g393g286g3g396g286g393g396g286g400g286g374g410g349g374g336g3g258g374g3g258g396g396g258g455g3g381

44、g296g3g448g258g367g437g286g400g3g381g296g3g410g455g393g286g3g410g455g393g286g69g258g373g286g856g3g24g286g296g258g437g367g410g855g3g127g286g396g381g882g367g286g374g336g410g346g3g258g396g396g258g455g3g400g410g396g437g272g410g437g396g286g69g258g373g286g3g24g258g410g258g3g410g455g393g286g3g396g286g393g3

45、96g286g400g286g374g410g349g374g336g3g410g346g286g3g94g410g396g437g272g410g437g396g286g3g400g410g396g437g272g410g437g396g286g69g258g373g286g853g3g258g400g3g400g393g286g272g349g296g349g286g282g3g349g374g3g18g367g258g437g400g286g3g24g286g296g349g374g349g410g349g381g374g400g856g3g24g286g296g258g437g367g

46、410g855g3g24g286g296g258g437g367g410g3g448g258g367g437g286g3g296g381g396g3g286g258g272g346g3g286g367g286g373g286g374g410g3g381g296g3g410g346g286g3g400g410g396g437g272g410g437g396g286g3g448g381g349g282g910g3g87g381g349g374g410g286g396g3g410g381g3g258g3g282g258g410g258g3g400g410g396g437g272g410g437g39

47、6g286g3g24g286g296g258g437g367g410g855g3“0x0“g3The MirrorLink API does not intend to specify, how information provided the MirrorLink has to be used to fulfil driver distraction guidelines. This information is provided from driver distraction guideline documents and associated test plans. If the Mir

48、rorLink API replicates functionality, available via OS/Platform APIs, then those API shall be used, as defined in the Platform specific specifications. The platform specific API may rearrange the defined parameter, or add additional parameter. The platform specific API shall not remove any parameter

49、. ETSI ETSI TS 103 544-15 V1.3.0 (2017-10)10 5 Definitions 5.1 0xE- Structure Rect Table 2: Structure Rect g38g286g258g410g437g396g286g3g69g258g373g286g3 g24g286g400g272g396g349g393g410g349g381g374g3 g100g455g393g286g3 g4g87g47g3g62g286g448g286g367g3g454g3g3 g44g381g396g349g460g381g374g410g258g367g3g381g296g296g400g286g410g3g381g296g3g410g346g286g3g437g393g393g286g396g3g367g286g296g410g3g272g381g396g374g286g396g3 g437g349g374g410g1005g1010g3 g1005g1085g3g455g3g3 g115g286g396g410g349g272g258g367g3g381g296g296g400g286g410g3g381g296g3g410g346g286g3g437g393g39