path: root/docs/Classes/SDLRegisterAppInterface.html

<h1>SDLRegisterAppInterface Class Reference</h1>

<h3>Section Contents</h3>

<ul>
  <li><a href="#section--init">-init</a></li>
  <li><a href="#section--initWithDictionary:">-initWithDictionary:</a></li>
  <li><a href="#section--initWithLifecycleConfiguration:">-initWithLifecycleConfiguration:</a></li>
  <li><a href="#section--initWithAppName:appId:languageDesired:">-initWithAppName:appId:languageDesired:</a></li>
  <li><a href="#section--initWithAppName:appId:languageDesired:isMediaApp:appType:shortAppName:">-initWithAppName:appId:languageDesired:isMediaApp:appType:shortAppName:</a></li>
  <li><a href="#section--initWithAppName:appId:languageDesired:isMediaApp:appType:shortAppName:ttsName:vrSynonyms:hmiDisplayLanguageDesired:resumeHash:">-initWithAppName:appId:languageDesired:isMediaApp:appType:shortAppName:ttsName:vrSynonyms:hmiDisplayLanguageDesired:resumeHash:</a></li>
  <li><a href="#section-syncMsgVersion">syncMsgVersion</a></li>
  <li><a href="#section-appName">appName</a></li>
  <li><a href="#section-ttsName">ttsName</a></li>
  <li><a href="#section-ngnMediaScreenAppName">ngnMediaScreenAppName</a></li>
  <li><a href="#section-vrSynonyms">vrSynonyms</a></li>
  <li><a href="#section-isMediaApplication">isMediaApplication</a></li>
  <li><a href="#section-languageDesired">languageDesired</a></li>
  <li><a href="#section-hmiDisplayLanguageDesired">hmiDisplayLanguageDesired</a></li>
  <li><a href="#section-appHMIType">appHMIType</a></li>
  <li><a href="#section-hashID">hashID</a></li>
  <li><a href="#section-deviceInfo">deviceInfo</a></li>
  <li><a href="#section-appID">appID</a></li>
  <li><a href="#section-appInfo">appInfo</a></li>
</ul>

<h3>Overview</h3>

<p>Registers the application&rsquo;s interface with SDL&reg;, declaring properties of
 the registration, including the messaging interface version, the app name,
 etc. The mobile application must establish its interface registration with
 SDL before any other interaction with SDL&reg; can take place. The
 registration lasts until it is terminated either by the application calling
 the <i> SDLUnregisterAppInterface</i> method, or by SDL&reg;
 sending an <i> SDLOnAppInterfaceUnregistered</i> notification, or
 by loss of the underlying transport connection, or closing of the underlying
 message transmission protocol RPC session
 <p>
 Until the application receives its first <i>SDLOnHMIStatus</i>
 Notification, its HMI Status is assumed to be: <i>
 SDLHMILevel</i>=NONE, <i>
 SDLAudioStreamingState
 </i>=NOT_AUDIBLE, <i>
 SDLSystemContext</i>=MAIN
 <p>
 All SDL&reg; resources which the application creates or uses (e.g. Choice
 Sets, Command Menu, etc.) are associated with the application&rsquo;s interface
 registration. Therefore, when the interface registration ends, the SDL&reg;
 resources associated with the application are disposed of. As a result, even
 though the application itself may continue to run on its host platform (e.g.
 mobile device) after the interface registration terminates, the application
 will not be able to use the SDL&reg; HMI without first establishing a new
 interface registration and re-creating its required SDL&reg; resources. That
 is, SDL&reg; resources created by (or on behalf of) an application do not
 persist beyond the life-span of the interface registration
 <p>
 Resources and settings whose lifespan is tied to the duration of an
 application&rsquo;s interface registration:<br/>
 <ul>
 <li>Choice Sets</li>
 <li>Command Menus (built by successive calls to <i>SDLAddCommand
 </i>)</li>
 <li>Media clock timer display value</li>
 <li>Media clock timer display value</li>
 <li>Media clock timer display value</li>
 </ul>
 <p>
 The autoActivateID is used to grant an application the HMILevel and
 AudioStreamingState it had when it last disconnected
 <p>
 <b>Notes: </b>The autoActivateID parameter, and associated behavior, is
 currently ignored by SDL&reg;
 <p>
 When first calling this method (i.e. first time within life cycle of mobile
 app), an autoActivateID should not be included. After successfully
 registering an interface, an autoActivateID is returned to the mobile
 application for it to use in subsequent connections. If the connection
 between SDL&reg; and the mobile application is lost, such as the vehicle is
 turned off while the application is running, the autoActivateID can then be
 passed in another call to RegisterAppInterface to re-acquire <i>
 SDLHMILevel</i>=FULL
 <p>
 If the application intends to stream audio it is important to indicate so via
 the isMediaApp parameter. When set to true, audio will reliably stream
 without any configuration required by the user. When not set, audio may
 stream, depending on what the user might have manually configured as a media
 source on SDL&reg;
 <p>
 There is no time limit for how long the autoActivateID is <q>valid</q> (i.e. would
 confer focus and opt-in)
 <p>
 <b>HMILevel is not defined before registering</b><br/>
 </p></p>

<p>@since SDL 1.0</p>

<div class="aside aside-see">
    <p class="aside-title">See</p>
    SDLUnregisterAppInterface SDLOnAppInterfaceUnregistered

</div>


<section class="section task-group-section">
  <h3 id="section--init">
      -init
  </h3>
  
  <p>@abstract Constructs a new SDLRegisterAppInterface object</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight"><code><span class="k">-</span> <span class="p">(</span><span class="n">instancetype</span><span class="p">)</span><span class="n">init</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight"><code><span class="nf">init</span><span class="o">!</span><span class="p">()</span></code></pre>

  
  
  
  <h3 id="section--initWithDictionary:">
      -initWithDictionary:
  </h3>
  
  <p>@abstract Constructs a new SDLRegisterAppInterface object indicated by the dictionary parameter</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight"><code><span class="k">-</span> <span class="p">(</span><span class="n">instancetype</span><span class="p">)</span><span class="nf">initWithDictionary</span><span class="p">:(</span><span class="n">NSMutableDictionary</span> <span class="o">*</span><span class="p">)</span><span class="nv">dict</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight"><code><span class="nf">init</span><span class="o">!</span><span class="p">(</span><span class="n">dictionary</span> <span class="nv">dict</span><span class="p">:</span> <span class="kt">NSMutableDictionary</span><span class="o">!</span><span class="p">)</span></code></pre>

  
  
  <h4>Parameters</h4>
  <dl>
      <dt>dict</dt>
      <dd><p>The dictionary to use</p>
</dd>
  </dl>
  
  <h3 id="section--initWithLifecycleConfiguration:">
      -initWithLifecycleConfiguration:
  </h3>
  
  <p>Undocumented</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight"><code><span class="k">@interface</span> <span class="nc">SDLRegisterAppInterface</span> <span class="p">:</span> <span class="nc">SDLRPCRequest</span></code></pre>

  
  
  
  
  <h3 id="section--initWithAppName:appId:languageDesired:">
      -initWithAppName:appId:languageDesired:
  </h3>
  
  <p>Undocumented</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight"><code><span class="k">@interface</span> <span class="nc">SDLRegisterAppInterface</span> <span class="p">:</span> <span class="nc">SDLRPCRequest</span></code></pre>

  
  
  
  
  <h3 id="section--initWithAppName:appId:languageDesired:isMediaApp:appType:shortAppName:">
      -initWithAppName:appId:languageDesired:isMediaApp:appType:shortAppName:
  </h3>
  
  <p>Undocumented</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight"><code><span class="k">@interface</span> <span class="nc">SDLRegisterAppInterface</span> <span class="p">:</span> <span class="nc">SDLRPCRequest</span></code></pre>

  
  
  
  
  <h3 id="section--initWithAppName:appId:languageDesired:isMediaApp:appType:shortAppName:ttsName:vrSynonyms:hmiDisplayLanguageDesired:resumeHash:">
      -initWithAppName:appId:languageDesired:isMediaApp:appType:shortAppName:ttsName:vrSynonyms:hmiDisplayLanguageDesired:resumeHash:
  </h3>
  
  <p>Undocumented</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight"><code><span class="k">@interface</span> <span class="nc">SDLRegisterAppInterface</span> <span class="p">:</span> <span class="nc">SDLRPCRequest</span></code></pre>

  
  
  
  
  <h3 id="section-syncMsgVersion">
      syncMsgVersion
  </h3>
  
  <p>@abstract The version of the SDL interface</p>

<p>Required</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight"><code><span class="k">@property</span> <span class="p">(</span><span class="n">readwrite</span><span class="p">,</span> <span class="n">strong</span><span class="p">,</span> <span class="n">atomic</span><span class="p">)</span> <span class="n"><a href="../Classes/SDLSyncMsgVersion.html">SDLSyncMsgVersion</a></span> <span class="o">*</span><span class="n">syncMsgVersion</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight"><code><span class="k">var</span> <span class="nv">syncMsgVersion</span><span class="p">:</span> <span class="kt"><a href="../Classes/SDLSyncMsgVersion.html">SDLSyncMsgVersion</a></span><span class="o">!</span> <span class="p">{</span> <span class="k">get</span> <span class="k">set</span> <span class="p">}</span></code></pre>

  
  
  
  <h3 id="section-appName">
      appName
  </h3>
  
  <p>@abstract The Mobile Application&rsquo;s Name, This name is displayed in the SDL Mobile Applications menu. It also serves as the unique identifier of the application for SmartDeviceLink</p>

<p>@discussion 
 <li>Needs to be unique over all applications.</li>
 <li>May not be empty.</li>
 <li>May not start with a new line character.</li>
 <li>May not interfere with any name or synonym of previously registered applications and any predefined blacklist of words (global commands).</li>
 <li>Needs to be unique over all applications. Applications with the same name will be rejected.</li></p>

<p>Required, Max length 100 chars</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight"><code><span class="k">@property</span> <span class="p">(</span><span class="n">readwrite</span><span class="p">,</span> <span class="n">strong</span><span class="p">,</span> <span class="n">atomic</span><span class="p">)</span> <span class="n">NSString</span> <span class="o">*</span><span class="n">appName</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight"><code><span class="k">var</span> <span class="nv">appName</span><span class="p">:</span> <span class="kt">String</span><span class="o">!</span> <span class="p">{</span> <span class="k">get</span> <span class="k">set</span> <span class="p">}</span></code></pre>

  
  
  
  <h3 id="section-ttsName">
      ttsName
  </h3>
  
  <p>@abstract TTS string for VR recognition of the mobile application name.</p>

<p>@discussion Meant to overcome any failing on speech engine in properly pronouncing / understanding app name.
 <li>Needs to be unique over all applications.</li>
 <li>May not be empty.</li>
 <li>May not start with a new line character.</li></p>

<p>Optional, Array of SDLTTSChunk, Array size 1 - 100</p>

<p>@since SDL 2.0
 - see: SDLTTSChunk</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight"><code><span class="k">@property</span> <span class="p">(</span><span class="n">readwrite</span><span class="p">,</span> <span class="n">strong</span><span class="p">,</span> <span class="n">atomic</span><span class="p">)</span> <span class="n">NSMutableArray</span> <span class="o">*</span><span class="n">ttsName</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight"><code><span class="k">var</span> <span class="nv">ttsName</span><span class="p">:</span> <span class="kt">NSMutableArray</span><span class="o">!</span> <span class="p">{</span> <span class="k">get</span> <span class="k">set</span> <span class="p">}</span></code></pre>

  
  
  
  <h3 id="section-ngnMediaScreenAppName">
      ngnMediaScreenAppName
  </h3>
  
  <p>@abstract A String representing an abbreviated version of the mobile application&rsquo;s name (if necessary) that will be displayed on the media screen</p>

<p>@discussion If not provided, the appName is used instead (and will be truncated if too long)</p>

<p>Optional, Max length 100 chars</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight"><code><span class="k">@property</span> <span class="p">(</span><span class="n">readwrite</span><span class="p">,</span> <span class="n">strong</span><span class="p">,</span> <span class="n">atomic</span><span class="p">)</span> <span class="n">NSString</span> <span class="o">*</span><span class="n">ngnMediaScreenAppName</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight"><code><span class="k">var</span> <span class="nv">ngnMediaScreenAppName</span><span class="p">:</span> <span class="kt">String</span><span class="o">!</span> <span class="p">{</span> <span class="k">get</span> <span class="k">set</span> <span class="p">}</span></code></pre>

  
  
  
  <h3 id="section-vrSynonyms">
      vrSynonyms
  </h3>
  
  <p>@abstract Defines a additional voice recognition commands</p>

<p>@discussion May not interfere with any app name of previously registered applications and any predefined blacklist of words (global commands)</p>

<p>Optional, Array of Strings, Array length 1 - 100, Max String length 40</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight"><code><span class="k">@property</span> <span class="p">(</span><span class="n">readwrite</span><span class="p">,</span> <span class="n">strong</span><span class="p">,</span> <span class="n">atomic</span><span class="p">)</span> <span class="n">NSMutableArray</span> <span class="o">*</span><span class="n">vrSynonyms</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight"><code><span class="k">var</span> <span class="nv">vrSynonyms</span><span class="p">:</span> <span class="kt">NSMutableArray</span><span class="o">!</span> <span class="p">{</span> <span class="k">get</span> <span class="k">set</span> <span class="p">}</span></code></pre>

  
  
  
  <h3 id="section-isMediaApplication">
      isMediaApplication
  </h3>
  
  <p>@abstract Indicates if the application is a media or a non-media application.</p>

<p>@discussion Only media applications will be able to stream audio to head units that is audible outside of the BT media source.</p>

<p>Required, Boolean</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight"><code><span class="k">@property</span> <span class="p">(</span><span class="n">readwrite</span><span class="p">,</span> <span class="n">strong</span><span class="p">,</span> <span class="n">atomic</span><span class="p">)</span> <span class="n">NSNumber</span> <span class="o">*</span><span class="n">isMediaApplication</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight"><code><span class="k">var</span> <span class="nv">isMediaApplication</span><span class="p">:</span> <span class="kt">NSNumber</span><span class="o">!</span> <span class="p">{</span> <span class="k">get</span> <span class="k">set</span> <span class="p">}</span></code></pre>

  
  
  
  <h3 id="section-languageDesired">
      languageDesired
  </h3>
  
  <p>@abstract A Language enumeration indicating what language the application intends to use for user interaction (TTS and VR).</p>

<p>@discussion If there is a mismatch with the head unit, the app will be able to change this registration with changeRegistration prior to app being brought into focus.</p>

<p>Required</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight"><code><span class="k">@property</span> <span class="p">(</span><span class="n">readwrite</span><span class="p">,</span> <span class="n">strong</span><span class="p">,</span> <span class="n">atomic</span><span class="p">)</span> <span class="n"><a href="../Classes/SDLLanguage.html">SDLLanguage</a></span> <span class="o">*</span><span class="n">languageDesired</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight"><code><span class="k">var</span> <span class="nv">languageDesired</span><span class="p">:</span> <span class="kt"><a href="../Classes/SDLLanguage.html">SDLLanguage</a></span><span class="o">!</span> <span class="p">{</span> <span class="k">get</span> <span class="k">set</span> <span class="p">}</span></code></pre>

  
  
  
  <h3 id="section-hmiDisplayLanguageDesired">
      hmiDisplayLanguageDesired
  </h3>
  
  <p>@abstract An enumeration indicating what language the application intends to use for user interaction (Display).</p>

<p>@discussion If there is a mismatch with the head unit, the app will be able to change this registration with changeRegistration prior to app being brought into focus.</p>

<p>Required</p>

<p>@since SDL 2.0</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight"><code><span class="k">@property</span> <span class="p">(</span><span class="n">readwrite</span><span class="p">,</span> <span class="n">strong</span><span class="p">,</span> <span class="n">atomic</span><span class="p">)</span> <span class="n"><a href="../Classes/SDLLanguage.html">SDLLanguage</a></span> <span class="o">*</span><span class="n">hmiDisplayLanguageDesired</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight"><code><span class="k">var</span> <span class="nv">hmiDisplayLanguageDesired</span><span class="p">:</span> <span class="kt"><a href="../Classes/SDLLanguage.html">SDLLanguage</a></span><span class="o">!</span> <span class="p">{</span> <span class="k">get</span> <span class="k">set</span> <span class="p">}</span></code></pre>

  
  
  
  <h3 id="section-appHMIType">
      appHMIType
  </h3>
  
  <p>@abstract A list of all applicable app types stating which classifications to be given to the app.</p>

<p>Optional, Array of SDLAppHMIType, Array size 1 - 100</p>

<p>@since SDL 2.0
 - see: SDLAppHMIType</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight"><code><span class="k">@property</span> <span class="p">(</span><span class="n">readwrite</span><span class="p">,</span> <span class="n">strong</span><span class="p">,</span> <span class="n">atomic</span><span class="p">)</span> <span class="n">NSMutableArray</span> <span class="o">*</span><span class="n">appHMIType</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight"><code><span class="k">var</span> <span class="nv">appHMIType</span><span class="p">:</span> <span class="kt">NSMutableArray</span><span class="o">!</span> <span class="p">{</span> <span class="k">get</span> <span class="k">set</span> <span class="p">}</span></code></pre>

  
  
  
  <h3 id="section-hashID">
      hashID
  </h3>
  
  <p>@abstract ID used to uniquely identify current state of all app data that can persist through connection cycles (e.g. ignition cycles).</p>

<p>@discussion This registered data (commands, submenus, choice sets, etc.) can be reestablished without needing to explicitly reregister each piece. If omitted, then the previous state of an app&rsquo;s commands, etc. will not be restored. </p>

<p>When sending hashID, all RegisterAppInterface parameters should still be provided (e.g. ttsName, etc.).</p>

<p>Optional, max length 100 chars</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight"><code><span class="k">@property</span> <span class="p">(</span><span class="n">readwrite</span><span class="p">,</span> <span class="n">strong</span><span class="p">,</span> <span class="n">atomic</span><span class="p">)</span> <span class="n">NSString</span> <span class="o">*</span><span class="n">hashID</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight"><code><span class="k">var</span> <span class="nv">hashID</span><span class="p">:</span> <span class="kt">String</span><span class="o">!</span> <span class="p">{</span> <span class="k">get</span> <span class="k">set</span> <span class="p">}</span></code></pre>

  
  
  
  <h3 id="section-deviceInfo">
      deviceInfo
  </h3>
  
  <p>@abstract Information about the connecting device</p>

<p>Optional</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight"><code><span class="k">@property</span> <span class="p">(</span><span class="n">readwrite</span><span class="p">,</span> <span class="n">strong</span><span class="p">,</span> <span class="n">atomic</span><span class="p">)</span> <span class="n"><a href="../Classes/SDLDeviceInfo.html">SDLDeviceInfo</a></span> <span class="o">*</span><span class="n">deviceInfo</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight"><code><span class="k">var</span> <span class="nv">deviceInfo</span><span class="p">:</span> <span class="kt"><a href="../Classes/SDLDeviceInfo.html">SDLDeviceInfo</a></span><span class="o">!</span> <span class="p">{</span> <span class="k">get</span> <span class="k">set</span> <span class="p">}</span></code></pre>

  
  
  
  <h3 id="section-appID">
      appID
  </h3>
  
  <p>@abstract ID used to validate app with policy table entries</p>

<p>Required, max length 100</p>

<p>@since SDL 2.0</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight"><code><span class="k">@property</span> <span class="p">(</span><span class="n">readwrite</span><span class="p">,</span> <span class="n">strong</span><span class="p">,</span> <span class="n">atomic</span><span class="p">)</span> <span class="n">NSString</span> <span class="o">*</span><span class="n">appID</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight"><code><span class="k">var</span> <span class="nv">appID</span><span class="p">:</span> <span class="kt">String</span><span class="o">!</span> <span class="p">{</span> <span class="k">get</span> <span class="k">set</span> <span class="p">}</span></code></pre>

  
  
  
  <h3 id="section-appInfo">
      appInfo
  </h3>
  
  <p>@abstract Information about the application running</p>

<p>Optional</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight"><code><span class="k">@property</span> <span class="p">(</span><span class="n">readwrite</span><span class="p">,</span> <span class="n">strong</span><span class="p">,</span> <span class="n">atomic</span><span class="p">)</span> <span class="n"><a href="../Classes/SDLAppInfo.html">SDLAppInfo</a></span> <span class="o">*</span><span class="n">appInfo</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight"><code><span class="k">var</span> <span class="nv">appInfo</span><span class="p">:</span> <span class="kt"><a href="../Classes/SDLAppInfo.html">SDLAppInfo</a></span><span class="o">!</span> <span class="p">{</span> <span class="k">get</span> <span class="k">set</span> <span class="p">}</span></code></pre>

  
  
  
</section>