path: root/docs/Classes/SDLSystemCapabilityManager.html

<h1>SDLSystemCapabilityManager Class Reference</h1>

<h3>Section Contents</h3>

<ul>
  <li><a href="#section-displays">displays</a></li>
  <li><a href="#section-displayCapabilities">displayCapabilities</a></li>
  <li><a href="#section-hmiCapabilities">hmiCapabilities</a></li>
  <li><a href="#section-softButtonCapabilities">softButtonCapabilities</a></li>
  <li><a href="#section-buttonCapabilities">buttonCapabilities</a></li>
  <li><a href="#section-presetBankCapabilities">presetBankCapabilities</a></li>
  <li><a href="#section-hmiZoneCapabilities">hmiZoneCapabilities</a></li>
  <li><a href="#section-speechCapabilities">speechCapabilities</a></li>
  <li><a href="#section-prerecordedSpeechCapabilities">prerecordedSpeechCapabilities</a></li>
  <li><a href="#section-vrCapability">vrCapability</a></li>
  <li><a href="#section-audioPassThruCapabilities">audioPassThruCapabilities</a></li>
  <li><a href="#section-pcmStreamCapability">pcmStreamCapability</a></li>
  <li><a href="#section-appServicesCapabilities">appServicesCapabilities</a></li>
  <li><a href="#section-navigationCapability">navigationCapability</a></li>
  <li><a href="#section-phoneCapability">phoneCapability</a></li>
  <li><a href="#section-videoStreamingCapability">videoStreamingCapability</a></li>
  <li><a href="#section-remoteControlCapability">remoteControlCapability</a></li>
  <li><a href="#section-seatLocationCapability">seatLocationCapability</a></li>
  <li><a href="#section-driverDistractionCapability">driverDistractionCapability</a></li>
  <li><a href="#section-defaultMainWindowCapability">defaultMainWindowCapability</a></li>
  <li><a href="#section-supportsSubscriptions">supportsSubscriptions</a></li>
  <li><a href="#section--init">-init</a></li>
  <li><a href="#section--initWithConnectionManager:">-initWithConnectionManager:</a></li>
  <li><a href="#section--start">-start</a></li>
  <li><a href="#section--stop">-stop</a></li>
  <li><a href="#section--windowCapabilityWithWindowID:">-windowCapabilityWithWindowID:</a></li>
  <li><a href="#section--isCapabilitySupported:">-isCapabilitySupported:</a></li>
  <li><a href="#section--updateCapabilityType:completionHandler:">-updateCapabilityType:completionHandler:</a></li>
  <li><a href="#section--subscribeToCapabilityType:withUpdateHandler:">-subscribeToCapabilityType:withUpdateHandler:</a></li>
  <li><a href="#section--subscribeToCapabilityType:withObserver:selector:">-subscribeToCapabilityType:withObserver:selector:</a></li>
  <li><a href="#section--unsubscribeFromCapabilityType:withObserver:">-unsubscribeFromCapabilityType:withObserver:</a></li>
</ul>

<h3>Overview</h3>

<p>A manager that handles updating and subscribing to SDL capabilities.</p>


<section class="section task-group-section">
  <h3 id="section-displays">
      displays
  </h3>
  
  <p>Provides window capabilities of all displays connected with SDL. By default, one display is connected and supported which includes window capability information of the default main window of the display. May be nil if the system has not provided display and window capability information yet.</p>
<div class="aside aside-see">
    <p class="aside-title">See</p>
    SDLDisplayCapability

</div>

<p>Optional, @since SDL 6.0</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight objective_c"><code><span class="k">@property</span> <span class="p">(</span><span class="n">nonatomic</span><span class="p">,</span> <span class="n">strong</span><span class="p">,</span> <span class="n">readonly</span><span class="p">,</span> <span class="n">nullable</span><span class="p">)</span> <span class="n">NSArray</span><span class="o">&lt;</span><span class="n"><a href="../Classes/SDLDisplayCapability.html">SDLDisplayCapability</a></span> <span class="o">*&gt;</span> <span class="o">*</span><span class="n">displays</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight swift"><code><span class="k">var</span> <span class="nv">displays</span><span class="p">:</span> <span class="p">[</span><span class="kt"><a href="../Classes/SDLDisplayCapability.html">SDLDisplayCapability</a></span><span class="p">]?</span> <span class="p">{</span> <span class="k">get</span> <span class="p">}</span></code></pre>

  
  
  
  <h3 id="section-displayCapabilities">
      displayCapabilities
  </h3>
  
  <div class="aside aside-see">
    <p class="aside-title">See</p>
    SDLDisplayCapabilities

</div>

<p>Optional</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight objective_c"><code><span class="k">@property</span> <span class="p">(</span><span class="n">nonatomic</span><span class="p">,</span> <span class="n">strong</span><span class="p">,</span> <span class="n">readonly</span><span class="p">,</span> <span class="n">nullable</span><span class="p">)</span> <span class="n"><a href="../Classes/SDLDisplayCapabilities.html">SDLDisplayCapabilities</a></span> <span class="o">*</span><span class="n">displayCapabilities</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight swift"><code><span class="k">var</span> <span class="nv">displayCapabilities</span><span class="p">:</span> <span class="kt"><a href="../Classes/SDLDisplayCapabilities.html">SDLDisplayCapabilities</a></span><span class="p">?</span> <span class="p">{</span> <span class="k">get</span> <span class="p">}</span></code></pre>

  
  
  
  <h3 id="section-hmiCapabilities">
      hmiCapabilities
  </h3>
  
  <div class="aside aside-see">
    <p class="aside-title">See</p>
    SDLHMICapabilities

</div>

<p>Optional</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight objective_c"><code><span class="k">@property</span> <span class="p">(</span><span class="n">nonatomic</span><span class="p">,</span> <span class="n">strong</span><span class="p">,</span> <span class="n">readonly</span><span class="p">,</span> <span class="n">nullable</span><span class="p">)</span> <span class="n"><a href="../Classes/SDLHMICapabilities.html">SDLHMICapabilities</a></span> <span class="o">*</span><span class="n">hmiCapabilities</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight swift"><code><span class="k">var</span> <span class="nv">hmiCapabilities</span><span class="p">:</span> <span class="kt"><a href="../Classes/SDLHMICapabilities.html">SDLHMICapabilities</a></span><span class="p">?</span> <span class="p">{</span> <span class="k">get</span> <span class="p">}</span></code></pre>

  
  
  
  <h3 id="section-softButtonCapabilities">
      softButtonCapabilities
  </h3>
  
  <p>If returned, the platform supports on-screen SoftButtons</p>
<div class="aside aside-see">
    <p class="aside-title">See</p>
    SDLSoftButtonCapabilities

</div>

<p>Optional, Array of length 1 - 100, of SDLSoftButtonCapabilities</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight objective_c"><code><span class="k">@property</span> <span class="p">(</span><span class="n">nonatomic</span><span class="p">,</span> <span class="n">copy</span><span class="p">,</span> <span class="n">readonly</span><span class="p">,</span> <span class="n">nullable</span><span class="p">)</span> <span class="n">NSArray</span><span class="o">&lt;</span><span class="n"><a href="../Classes/SDLSoftButtonCapabilities.html">SDLSoftButtonCapabilities</a></span> <span class="o">*&gt;</span> <span class="o">*</span><span class="n">softButtonCapabilities</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight swift"><code><span class="k">var</span> <span class="nv">softButtonCapabilities</span><span class="p">:</span> <span class="p">[</span><span class="kt"><a href="../Classes/SDLSoftButtonCapabilities.html">SDLSoftButtonCapabilities</a></span><span class="p">]?</span> <span class="p">{</span> <span class="k">get</span> <span class="p">}</span></code></pre>

  
  
  
  <h3 id="section-buttonCapabilities">
      buttonCapabilities
  </h3>
  
  <div class="aside aside-see">
    <p class="aside-title">See</p>
    SDLButtonCapabilities

</div>

<p>Optional, Array of length 1 - 100, of SDLButtonCapabilities</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight objective_c"><code><span class="k">@property</span> <span class="p">(</span><span class="n">nonatomic</span><span class="p">,</span> <span class="n">copy</span><span class="p">,</span> <span class="n">readonly</span><span class="p">,</span> <span class="n">nullable</span><span class="p">)</span> <span class="n">NSArray</span><span class="o">&lt;</span><span class="n"><a href="../Classes/SDLButtonCapabilities.html">SDLButtonCapabilities</a></span> <span class="o">*&gt;</span> <span class="o">*</span><span class="n">buttonCapabilities</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight swift"><code><span class="k">var</span> <span class="nv">buttonCapabilities</span><span class="p">:</span> <span class="p">[</span><span class="kt"><a href="../Classes/SDLButtonCapabilities.html">SDLButtonCapabilities</a></span><span class="p">]?</span> <span class="p">{</span> <span class="k">get</span> <span class="p">}</span></code></pre>

  
  
  
  <h3 id="section-presetBankCapabilities">
      presetBankCapabilities
  </h3>
  
  <p>If returned, the platform supports custom on-screen Presets</p>
<div class="aside aside-see">
    <p class="aside-title">See</p>
    SDLPresetBankCapabilities

</div>

<p>Optional</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight objective_c"><code><span class="k">@property</span> <span class="p">(</span><span class="n">nonatomic</span><span class="p">,</span> <span class="n">strong</span><span class="p">,</span> <span class="n">readonly</span><span class="p">,</span> <span class="n">nullable</span><span class="p">)</span> <span class="n"><a href="../Classes/SDLPresetBankCapabilities.html">SDLPresetBankCapabilities</a></span> <span class="o">*</span><span class="n">presetBankCapabilities</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight swift"><code><span class="k">var</span> <span class="nv">presetBankCapabilities</span><span class="p">:</span> <span class="kt"><a href="../Classes/SDLPresetBankCapabilities.html">SDLPresetBankCapabilities</a></span><span class="p">?</span> <span class="p">{</span> <span class="k">get</span> <span class="p">}</span></code></pre>

  
  
  
  <h3 id="section-hmiZoneCapabilities">
      hmiZoneCapabilities
  </h3>
  
  <div class="aside aside-see">
    <p class="aside-title">See</p>
    SDLHMIZoneCapabilities

</div>

<p>Optional, Array of length 1 - 100, of SDLHMIZoneCapabilities</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight objective_c"><code><span class="k">@property</span> <span class="p">(</span><span class="n">nonatomic</span><span class="p">,</span> <span class="n">copy</span><span class="p">,</span> <span class="n">readonly</span><span class="p">,</span> <span class="n">nullable</span><span class="p">)</span> <span class="n">NSArray</span><span class="o">&lt;</span><span class="n"><a href="../Type%20Definitions.html#/c:SDLHMIZoneCapabilities.h@T@SDLHMIZoneCapabilities">SDLHMIZoneCapabilities</a></span><span class="o">&gt;</span> <span class="o">*</span><span class="n">hmiZoneCapabilities</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight swift"><code><span class="k">var</span> <span class="nv">hmiZoneCapabilities</span><span class="p">:</span> <span class="p">[</span><span class="kt"><a href="../Type%20Definitions.html#/c:SDLHMIZoneCapabilities.h@T@SDLHMIZoneCapabilities">SDLHMIZoneCapabilities</a></span><span class="p">]?</span> <span class="p">{</span> <span class="k">get</span> <span class="p">}</span></code></pre>

  
  
  
  <h3 id="section-speechCapabilities">
      speechCapabilities
  </h3>
  
  <div class="aside aside-see">
    <p class="aside-title">See</p>
    SDLSpeechCapabilities

</div>

<p>Optional, Array of length 1 - 100, of SDLSpeechCapabilities</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight objective_c"><code><span class="k">@property</span> <span class="p">(</span><span class="n">nonatomic</span><span class="p">,</span> <span class="n">copy</span><span class="p">,</span> <span class="n">readonly</span><span class="p">,</span> <span class="n">nullable</span><span class="p">)</span> <span class="n">NSArray</span><span class="o">&lt;</span><span class="n"><a href="../Type%20Definitions.html#/c:SDLSpeechCapabilities.h@T@SDLSpeechCapabilities">SDLSpeechCapabilities</a></span><span class="o">&gt;</span> <span class="o">*</span><span class="n">speechCapabilities</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight swift"><code><span class="k">var</span> <span class="nv">speechCapabilities</span><span class="p">:</span> <span class="p">[</span><span class="kt"><a href="../Type%20Definitions.html#/c:SDLSpeechCapabilities.h@T@SDLSpeechCapabilities">SDLSpeechCapabilities</a></span><span class="p">]?</span> <span class="p">{</span> <span class="k">get</span> <span class="p">}</span></code></pre>

  
  
  
  <h3 id="section-prerecordedSpeechCapabilities">
      prerecordedSpeechCapabilities
  </h3>
  
  <div class="aside aside-see">
    <p class="aside-title">See</p>
    SDLPrerecordedSpeech

</div>

<p>Optional, Array of length 1 - 100, of SDLPrerecordedSpeech</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight objective_c"><code><span class="k">@property</span> <span class="p">(</span><span class="n">nonatomic</span><span class="p">,</span> <span class="n">copy</span><span class="p">,</span> <span class="n">readonly</span><span class="p">,</span> <span class="n">nullable</span><span class="p">)</span> <span class="n">NSArray</span><span class="o">&lt;</span><span class="n"><a href="../Type%20Definitions.html#/c:SDLPrerecordedSpeech.h@T@SDLPrerecordedSpeech">SDLPrerecordedSpeech</a></span><span class="o">&gt;</span> <span class="o">*</span><span class="n">prerecordedSpeechCapabilities</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight swift"><code><span class="k">var</span> <span class="nv">prerecordedSpeechCapabilities</span><span class="p">:</span> <span class="p">[</span><span class="kt"><a href="../Type%20Definitions.html#/c:SDLPrerecordedSpeech.h@T@SDLPrerecordedSpeech">SDLPrerecordedSpeech</a></span><span class="p">]?</span> <span class="p">{</span> <span class="k">get</span> <span class="p">}</span></code></pre>

  
  
  
  <h3 id="section-vrCapability">
      vrCapability
  </h3>
  
  <div class="aside aside-see">
    <p class="aside-title">See</p>
    SDLVRCapabilities

</div>

<p>True if the head unit supports voice recognition; false if not.</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight objective_c"><code><span class="k">@property</span> <span class="p">(</span><span class="n">nonatomic</span><span class="p">,</span> <span class="n">readonly</span><span class="p">)</span> <span class="n">BOOL</span> <span class="n">vrCapability</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight swift"><code><span class="k">var</span> <span class="nv">vrCapability</span><span class="p">:</span> <span class="kt">Bool</span> <span class="p">{</span> <span class="k">get</span> <span class="p">}</span></code></pre>

  
  
  
  <h3 id="section-audioPassThruCapabilities">
      audioPassThruCapabilities
  </h3>
  
  <div class="aside aside-see">
    <p class="aside-title">See</p>
    SDLAudioPassThruCapabilities

</div>

<p>Optional, Array of length 1 - 100, of SDLAudioPassThruCapabilities</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight objective_c"><code><span class="k">@property</span> <span class="p">(</span><span class="n">nonatomic</span><span class="p">,</span> <span class="n">copy</span><span class="p">,</span> <span class="n">readonly</span><span class="p">,</span> <span class="n">nullable</span><span class="p">)</span> <span class="n">NSArray</span><span class="o">&lt;</span><span class="n"><a href="../Classes/SDLAudioPassThruCapabilities.html">SDLAudioPassThruCapabilities</a></span> <span class="o">*&gt;</span> <span class="o">*</span><span class="n">audioPassThruCapabilities</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight swift"><code><span class="k">var</span> <span class="nv">audioPassThruCapabilities</span><span class="p">:</span> <span class="p">[</span><span class="kt"><a href="../Classes/SDLAudioPassThruCapabilities.html">SDLAudioPassThruCapabilities</a></span><span class="p">]?</span> <span class="p">{</span> <span class="k">get</span> <span class="p">}</span></code></pre>

  
  
  
  <h3 id="section-pcmStreamCapability">
      pcmStreamCapability
  </h3>
  
  <div class="aside aside-see">
    <p class="aside-title">See</p>
    SDLAudioPassThruCapabilities

</div>

<p>Optional, Array of length 1 - 100, of SDLAudioPassThruCapabilities</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight objective_c"><code><span class="k">@property</span> <span class="p">(</span><span class="n">nonatomic</span><span class="p">,</span> <span class="n">strong</span><span class="p">,</span> <span class="n">readonly</span><span class="p">,</span> <span class="n">nullable</span><span class="p">)</span> <span class="n"><a href="../Classes/SDLAudioPassThruCapabilities.html">SDLAudioPassThruCapabilities</a></span> <span class="o">*</span><span class="n">pcmStreamCapability</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight swift"><code><span class="k">var</span> <span class="nv">pcmStreamCapability</span><span class="p">:</span> <span class="kt"><a href="../Classes/SDLAudioPassThruCapabilities.html">SDLAudioPassThruCapabilities</a></span><span class="p">?</span> <span class="p">{</span> <span class="k">get</span> <span class="p">}</span></code></pre>

  
  
  
  <h3 id="section-appServicesCapabilities">
      appServicesCapabilities
  </h3>
  
  <p>If returned, the platform supports app services</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight objective_c"><code><span class="k">@property</span> <span class="p">(</span><span class="n">nonatomic</span><span class="p">,</span> <span class="n">strong</span><span class="p">,</span> <span class="n">readonly</span><span class="p">,</span> <span class="n">nullable</span><span class="p">)</span> <span class="n"><a href="../Classes/SDLAppServicesCapabilities.html">SDLAppServicesCapabilities</a></span> <span class="o">*</span><span class="n">appServicesCapabilities</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight swift"><code><span class="k">var</span> <span class="nv">appServicesCapabilities</span><span class="p">:</span> <span class="kt"><a href="../Classes/SDLAppServicesCapabilities.html">SDLAppServicesCapabilities</a></span><span class="p">?</span> <span class="p">{</span> <span class="k">get</span> <span class="p">}</span></code></pre>

  
  
  
  <h3 id="section-navigationCapability">
      navigationCapability
  </h3>
  
  <p>If returned, the platform supports navigation</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight objective_c"><code><span class="k">@property</span> <span class="p">(</span><span class="n">nonatomic</span><span class="p">,</span> <span class="n">strong</span><span class="p">,</span> <span class="n">readonly</span><span class="p">,</span> <span class="n">nullable</span><span class="p">)</span> <span class="n"><a href="../Classes/SDLNavigationCapability.html">SDLNavigationCapability</a></span> <span class="o">*</span><span class="n">navigationCapability</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight swift"><code><span class="k">var</span> <span class="nv">navigationCapability</span><span class="p">:</span> <span class="kt"><a href="../Classes/SDLNavigationCapability.html">SDLNavigationCapability</a></span><span class="p">?</span> <span class="p">{</span> <span class="k">get</span> <span class="p">}</span></code></pre>

  
  
  
  <h3 id="section-phoneCapability">
      phoneCapability
  </h3>
  
  <p>If returned, the platform supports making phone calls</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight objective_c"><code><span class="k">@property</span> <span class="p">(</span><span class="n">nonatomic</span><span class="p">,</span> <span class="n">strong</span><span class="p">,</span> <span class="n">readonly</span><span class="p">,</span> <span class="n">nullable</span><span class="p">)</span> <span class="n"><a href="../Classes/SDLPhoneCapability.html">SDLPhoneCapability</a></span> <span class="o">*</span><span class="n">phoneCapability</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight swift"><code><span class="k">var</span> <span class="nv">phoneCapability</span><span class="p">:</span> <span class="kt"><a href="../Classes/SDLPhoneCapability.html">SDLPhoneCapability</a></span><span class="p">?</span> <span class="p">{</span> <span class="k">get</span> <span class="p">}</span></code></pre>

  
  
  
  <h3 id="section-videoStreamingCapability">
      videoStreamingCapability
  </h3>
  
  <p>If returned, the platform supports video streaming</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight objective_c"><code><span class="k">@property</span> <span class="p">(</span><span class="n">nonatomic</span><span class="p">,</span> <span class="n">strong</span><span class="p">,</span> <span class="n">readonly</span><span class="p">,</span> <span class="n">nullable</span><span class="p">)</span> <span class="n"><a href="../Classes/SDLVideoStreamingCapability.html">SDLVideoStreamingCapability</a></span> <span class="o">*</span><span class="n">videoStreamingCapability</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight swift"><code><span class="k">var</span> <span class="nv">videoStreamingCapability</span><span class="p">:</span> <span class="kt"><a href="../Classes/SDLVideoStreamingCapability.html">SDLVideoStreamingCapability</a></span><span class="p">?</span> <span class="p">{</span> <span class="k">get</span> <span class="p">}</span></code></pre>

  
  
  
  <h3 id="section-remoteControlCapability">
      remoteControlCapability
  </h3>
  
  <p>If returned, the platform supports remote control capabilities</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight objective_c"><code><span class="k">@property</span> <span class="p">(</span><span class="n">nonatomic</span><span class="p">,</span> <span class="n">strong</span><span class="p">,</span> <span class="n">readonly</span><span class="p">,</span> <span class="n">nullable</span><span class="p">)</span> <span class="n"><a href="../Classes/SDLRemoteControlCapabilities.html">SDLRemoteControlCapabilities</a></span> <span class="o">*</span><span class="n">remoteControlCapability</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight swift"><code><span class="k">var</span> <span class="nv">remoteControlCapability</span><span class="p">:</span> <span class="kt"><a href="../Classes/SDLRemoteControlCapabilities.html">SDLRemoteControlCapabilities</a></span><span class="p">?</span> <span class="p">{</span> <span class="k">get</span> <span class="p">}</span></code></pre>

  
  
  
  <h3 id="section-seatLocationCapability">
      seatLocationCapability
  </h3>
  
  <p>If returned, the platform supports remote control capabilities for seats</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight objective_c"><code><span class="k">@property</span> <span class="p">(</span><span class="n">nonatomic</span><span class="p">,</span> <span class="n">strong</span><span class="p">,</span> <span class="n">readonly</span><span class="p">,</span> <span class="n">nullable</span><span class="p">)</span> <span class="n"><a href="../Classes/SDLSeatLocationCapability.html">SDLSeatLocationCapability</a></span> <span class="o">*</span><span class="n">seatLocationCapability</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight swift"><code><span class="k">var</span> <span class="nv">seatLocationCapability</span><span class="p">:</span> <span class="kt"><a href="../Classes/SDLSeatLocationCapability.html">SDLSeatLocationCapability</a></span><span class="p">?</span> <span class="p">{</span> <span class="k">get</span> <span class="p">}</span></code></pre>

  
  
  
  <h3 id="section-driverDistractionCapability">
      driverDistractionCapability
  </h3>
  
  <p>If returned, the platform supports driver distraction capabilities</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight objective_c"><code><span class="k">@property</span> <span class="p">(</span><span class="n">nonatomic</span><span class="p">,</span> <span class="n">strong</span><span class="p">,</span> <span class="n">readonly</span><span class="p">,</span> <span class="n">nullable</span><span class="p">)</span> <span class="n"><a href="../Classes/SDLDriverDistractionCapability.html">SDLDriverDistractionCapability</a></span> <span class="o">*</span><span class="n">driverDistractionCapability</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight swift"><code><span class="k">var</span> <span class="nv">driverDistractionCapability</span><span class="p">:</span> <span class="kt"><a href="../Classes/SDLDriverDistractionCapability.html">SDLDriverDistractionCapability</a></span><span class="p">?</span> <span class="p">{</span> <span class="k">get</span> <span class="p">}</span></code></pre>

  
  
  
  <h3 id="section-defaultMainWindowCapability">
      defaultMainWindowCapability
  </h3>
  
  <p>Returns the window capability object of the default main window which is always pre-created by the connected system. This is a convenience method for easily accessing the capabilities of the default main window.</p>

<p>@returns The window capability object representing the default main window capabilities or nil if no window capabilities exist.</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight objective_c"><code><span class="k">@property</span> <span class="p">(</span><span class="n">nonatomic</span><span class="p">,</span> <span class="n">strong</span><span class="p">,</span> <span class="n">readonly</span><span class="p">,</span> <span class="n">nullable</span><span class="p">)</span> <span class="n"><a href="../Classes/SDLWindowCapability.html">SDLWindowCapability</a></span> <span class="o">*</span><span class="n">defaultMainWindowCapability</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight swift"><code><span class="k">var</span> <span class="nv">defaultMainWindowCapability</span><span class="p">:</span> <span class="kt"><a href="../Classes/SDLWindowCapability.html">SDLWindowCapability</a></span><span class="p">?</span> <span class="p">{</span> <span class="k">get</span> <span class="p">}</span></code></pre>

  
  
  
  <h3 id="section-supportsSubscriptions">
      supportsSubscriptions
  </h3>
  
  <p>YES if subscriptions are available on the connected module and you will automatically be notified if the value changes on the module. If NO, calls to <code>subscribe</code> methods will subscribe to updates, but the module will not automatically notify you. You will need to call <code>updateWithCapabilityType:completionHandler:</code> to force an update if you need one (though this should be rare). This does not apply to the <code>DISPLAYS</code> capability type which you can always subscribe to.</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight objective_c"><code><span class="k">@property</span> <span class="p">(</span><span class="n">nonatomic</span><span class="p">,</span> <span class="n">readonly</span><span class="p">)</span> <span class="n">BOOL</span> <span class="n">supportsSubscriptions</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight swift"><code><span class="k">var</span> <span class="nv">supportsSubscriptions</span><span class="p">:</span> <span class="kt">Bool</span> <span class="p">{</span> <span class="k">get</span> <span class="p">}</span></code></pre>

  
  
  
  <h3 id="section--init">
      -init
  </h3>
  
  <p>Init is unavailable. Dependencies must be injected using initWithConnectionManager:</p>

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

  
  
  
  <div>
    <h4>Return Value</h4>
    <p>nil</p>
  </div>
  
  <h3 id="section--initWithConnectionManager:">
      -initWithConnectionManager:
  </h3>
  
  <p>Creates a new system capability manager with a specified connection manager</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight objective_c"><code><span class="k">-</span> <span class="p">(</span><span class="n">nonnull</span> <span class="n">instancetype</span><span class="p">)</span><span class="nf">initWithConnectionManager</span><span class="p">:</span>
    <span class="p">(</span><span class="n">nonnull</span> <span class="n">id</span><span class="o">&lt;</span><span class="n">SDLConnectionManagerType</span><span class="o">&gt;</span><span class="p">)</span><span class="nv">manager</span><span class="p">;</span></code></pre>

  
  
  
  <h4>Parameters</h4>
  <dl>
      <dt>manager</dt>
      <dd><p>A connection manager to use to forward on RPCs</p></dd>
  </dl>
  <div>
    <h4>Return Value</h4>
    <p>An instance of SDLSystemCapabilityManager</p>
  </div>
  
  <h3 id="section--start">
      -start
  </h3>
  
  <p>Starts the manager. This method is used internally.</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight objective_c"><code><span class="k">-</span> <span class="p">(</span><span class="kt">void</span><span class="p">)</span><span class="n">start</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">start</span><span class="p">()</span></code></pre>

  
  
  
  <h3 id="section--stop">
      -stop
  </h3>
  
  <p>Stops the manager. This method is used internally.</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight objective_c"><code><span class="k">-</span> <span class="p">(</span><span class="kt">void</span><span class="p">)</span><span class="n">stop</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">stop</span><span class="p">()</span></code></pre>

  
  
  
  <h3 id="section--windowCapabilityWithWindowID:">
      -windowCapabilityWithWindowID:
  </h3>
  
  <p>Returns the window capability of one of your app&rsquo;s windows with the specified window ID that is on the primary display (i.e. the head unit itself). This is a convenience method to easily access capabilities of windows such as your apps&rsquo; widget windows.</p>

<p>To get the capabilities of the main window on the main display (i.e. your app&rsquo;s primary app screen on the head unit itself).</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight objective_c"><code><span class="k">-</span> <span class="p">(</span><span class="n">nullable</span> <span class="n"><a href="../Classes/SDLWindowCapability.html">SDLWindowCapability</a></span> <span class="o">*</span><span class="p">)</span><span class="nf">windowCapabilityWithWindowID</span><span class="p">:</span>
    <span class="p">(</span><span class="n">NSUInteger</span><span class="p">)</span><span class="nv">windowID</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">windowCapability</span><span class="p">(</span><span class="n">withWindowID</span> <span class="nv">windowID</span><span class="p">:</span> <span class="kt">UInt</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Classes/SDLWindowCapability.html">SDLWindowCapability</a></span><span class="p">?</span></code></pre>

  
  
  <h4>Parameters</h4>
  <dl>
      <dt>windowID</dt>
      <dd><p>The ID of the window from which to get capabilities
@returns The window capabilities of the window with the specified windowID, or nil if the window is not known or no window capabilities exist.</p></dd>
  </dl>
  
  <h3 id="section--isCapabilitySupported:">
      -isCapabilitySupported:
  </h3>
  
  <p>Returns whether or not the capability type is supported on the module. You can use this to check if subscribing to the capability will work. If this returns NO, then the feature is not supported by the head unit. If YES, the feature is supported by the head unit. You can subscribe to the capability type to get more information about the capability&rsquo;s support and features on the connected module.</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight objective_c"><code><span class="k">-</span> <span class="p">(</span><span class="n">BOOL</span><span class="p">)</span><span class="nf">isCapabilitySupported</span><span class="p">:(</span><span class="n">nonnull</span> <span class="n"><a href="../Type%20Definitions.html#/c:SDLSystemCapabilityType.h@T@SDLSystemCapabilityType">SDLSystemCapabilityType</a></span><span class="p">)</span><span class="nv">type</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">isCapabilitySupported</span><span class="p">(</span><span class="nv">type</span><span class="p">:</span> <span class="kt"><a href="../Type%20Definitions.html#/c:SDLSystemCapabilityType.h@T@SDLSystemCapabilityType">SDLSystemCapabilityType</a></span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt">Bool</span></code></pre>

  
  
  <h4>Parameters</h4>
  <dl>
      <dt>type</dt>
      <dd><p>The SystemCapabilityType that will be checked.</p></dd>
  </dl>
  <div>
    <h4>Return Value</h4>
    <p>Whether or not <code>type</code> is supported by the connected head unit.</p>
  </div>
  
  <h3 id="section--updateCapabilityType:completionHandler:">
      -updateCapabilityType:completionHandler:
  </h3>
  
  <p>This method has been superseded by the <code>subscribeToCapabilityType:</code> methods. You should use one of those methods instead unless you only want a value once (you don&rsquo;t want to keep a long-lasting observer) and it must be current (most capabilities do not need to be updated). If you have a separate subscription observer and are connected to a head unit that does not support subscriptions, when this method returns, it will also call all subscription callbacks that you&rsquo;ve set up with the new value if there is one. Therefore, you can use this method to force an update to all subscriptions of that particular type on head units that don&rsquo;t support subscriptions (<code>supportsSubscriptions == NO</code>).</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight objective_c"><code><span class="k">-</span> <span class="p">(</span><span class="kt">void</span><span class="p">)</span><span class="nf">updateCapabilityType</span><span class="p">:(</span><span class="n">nonnull</span> <span class="n"><a href="../Type%20Definitions.html#/c:SDLSystemCapabilityType.h@T@SDLSystemCapabilityType">SDLSystemCapabilityType</a></span><span class="p">)</span><span class="nv">type</span>
           <span class="nf">completionHandler</span><span class="p">:(</span><span class="n">nonnull</span> <span class="n"><a href="../Type%20Definitions.html#/c:SDLSystemCapabilityManager.h@T@SDLUpdateCapabilityHandler">SDLUpdateCapabilityHandler</a></span><span class="p">)</span><span class="nv">handler</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">updateCapabilityType</span><span class="p">(</span><span class="n">_</span> <span class="nv">type</span><span class="p">:</span> <span class="kt"><a href="../Type%20Definitions.html#/c:SDLSystemCapabilityType.h@T@SDLSystemCapabilityType">SDLSystemCapabilityType</a></span><span class="p">)</span> <span class="n">async</span> <span class="k">throws</span> <span class="o">-&gt;</span> <span class="kt">SDLSystemCapabilityManager</span></code></pre>

  
  
  <h4>Parameters</h4>
  <dl>
      <dt>type</dt>
      <dd><p>The type of capability to retrieve</p></dd>
      <dt>handler</dt>
      <dd><p>The handler to be called when the retrieval is complete</p></dd>
  </dl>
  
  <h3 id="section--subscribeToCapabilityType:withUpdateHandler:">
      -subscribeToCapabilityType:withUpdateHandler:
  </h3>
  
  <p>Subscribe to a particular capability type using a handler callback.</p>

<p>On v5.1.0+ systems (where <code>supportsSubscriptions == YES</code>):
This method will be called immediately with the current value if a subscription already exists and will be called every time the value is updated.</p>

<p>Note that when the cached value is returned, the <code>subscribed</code> flag on the handler will be false until the subscription completes successfully and a new value is retrieved.</p>

<p>On sub-v5.1.0 systems (where <code>supportsSubscriptions == NO</code>):
The method will be called immediately with the current value and will <em>not</em> be automatically called every time the value is updated, unless the <code>type</code> is <code>DISPLAYS</code> which is supported on every version. If <code>updateCapabilityType:completionHandler</code> is called and a new value is retrieved, this value will be updated then. If this is the first subscription of this <code><a href="../Type%20Definitions.html#/c:SDLSystemCapabilityType.h@T@SDLSystemCapabilityType">SDLSystemCapabilityType</a></code>, then the value will be retrieved and returned.</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight objective_c"><code><span class="k">-</span> <span class="p">(</span><span class="n">nullable</span> <span class="n">id</span><span class="o">&lt;</span><span class="n">NSObject</span><span class="o">&gt;</span><span class="p">)</span>
    <span class="nf">subscribeToCapabilityType</span><span class="p">:(</span><span class="n">nonnull</span> <span class="n"><a href="../Type%20Definitions.html#/c:SDLSystemCapabilityType.h@T@SDLSystemCapabilityType">SDLSystemCapabilityType</a></span><span class="p">)</span><span class="nv">type</span>
            <span class="nf">withUpdateHandler</span><span class="p">:</span>
                <span class="p">(</span><span class="n">nonnull</span> <span class="n"><a href="../Type%20Definitions.html#/c:SDLSystemCapabilityManager.h@T@SDLCapabilityUpdateWithErrorHandler">SDLCapabilityUpdateWithErrorHandler</a></span><span class="p">)</span><span class="nv">handler</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">subscribe</span><span class="p">(</span><span class="n">capabilityType</span> <span class="nv">type</span><span class="p">:</span> <span class="kt"><a href="../Type%20Definitions.html#/c:SDLSystemCapabilityType.h@T@SDLSystemCapabilityType">SDLSystemCapabilityType</a></span><span class="p">,</span> <span class="n">updateHandler</span> <span class="nv">handler</span><span class="p">:</span> <span class="kd">@escaping</span> <span class="kt"><a href="../Type%20Definitions.html#/c:SDLSystemCapabilityManager.h@T@SDLCapabilityUpdateWithErrorHandler">SDLCapabilityUpdateWithErrorHandler</a></span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt">NSObjectProtocol</span><span class="p">?</span></code></pre>

  
  
  <h4>Parameters</h4>
  <dl>
      <dt>type</dt>
      <dd><p>The type of capability to subscribe to</p></dd>
      <dt>handler</dt>
      <dd><p>The block to be called when the capability is updated with an error if one occurs</p></dd>
  </dl>
  <div>
    <h4>Return Value</h4>
    <p>An object that can be used to unsubscribe the block using unsubscribeFromCapabilityType:withObserver: by passing it in the observer callback, or nil if the manager can&rsquo;t attempt the subscription for some reason (such as the app being in HMI_NONE and the type is not DISPLAYS).</p>
  </div>
  
  <h3 id="section--subscribeToCapabilityType:withObserver:selector:">
      -subscribeToCapabilityType:withObserver:selector:
  </h3>
  
  <p>Subscribe to a particular capability type with a selector callback.</p>

<p>The selector supports the following parameters:</p>

<ol>
<li><p>No parameters e.g. <code>- (void)phoneCapabilityUpdated;</code></p></li>
<li><p>One <code>SDLSystemCapability *</code> parameter, e.g. <code>- (void)phoneCapabilityUpdated:(SDLSystemCapability *)capability</code></p></li>
<li><p>Two parameters, one <code>SDLSystemCapability *</code> parameter, and one <code>NSError</code> parameter, e.g. <code>- (void)phoneCapabilityUpdated:(SDLSystemCapability *)capability error:(NSError *)error</code></p></li>
<li><p>Three parameters, one <code>SDLSystemCapability *</code> parameter, one <code>NSError</code> parameter, and one <code>BOOL</code> parameter e.g. <code>- (void)phoneCapabilityUpdated:(SDLSystemCapability *)capability error:(NSError *)error subscribed:(BOOL)subscribed</code></p></li>
</ol>

<p>On v5.1.0+ systems (where <code>supportsSubscriptions == YES</code>):
This method will be called immediately with the current value if a subscription already exists and will be called every time the value is updated.</p>

<p>On sub-v5.1.0 systems (where <code>supportsSubscriptions == NO</code>):
The method will be called immediately with the current value and will <em>not</em> be automatically called every time the value is updated, unless the <code>type</code> is <code>DISPLAYS</code> which is supported on every version. If <code>updateCapabilityType:completionHandler</code> is called and a new value is retrieved, this value will be updated then. If this is the first subscription of this <code><a href="../Type%20Definitions.html#/c:SDLSystemCapabilityType.h@T@SDLSystemCapabilityType">SDLSystemCapabilityType</a></code>, then the value will be retrieved and returned.</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight objective_c"><code><span class="k">-</span> <span class="p">(</span><span class="n">BOOL</span><span class="p">)</span><span class="nf">subscribeToCapabilityType</span><span class="p">:(</span><span class="n">nonnull</span> <span class="n"><a href="../Type%20Definitions.html#/c:SDLSystemCapabilityType.h@T@SDLSystemCapabilityType">SDLSystemCapabilityType</a></span><span class="p">)</span><span class="nv">type</span>
                     <span class="nf">withObserver</span><span class="p">:(</span><span class="n">nonnull</span> <span class="n">id</span><span class="p">)</span><span class="nv">observer</span>
                         <span class="nf">selector</span><span class="p">:(</span><span class="n">nonnull</span> <span class="n">SEL</span><span class="p">)</span><span class="nv">selector</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">subscribe</span><span class="p">(</span><span class="n">toCapabilityType</span> <span class="nv">type</span><span class="p">:</span> <span class="kt"><a href="../Type%20Definitions.html#/c:SDLSystemCapabilityType.h@T@SDLSystemCapabilityType">SDLSystemCapabilityType</a></span><span class="p">,</span> <span class="n">withObserver</span> <span class="nv">observer</span><span class="p">:</span> <span class="kt">Any</span><span class="p">,</span> <span class="nv">selector</span><span class="p">:</span> <span class="kt">Selector</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt">Bool</span></code></pre>

  
  
  <h4>Parameters</h4>
  <dl>
      <dt>type</dt>
      <dd><p>The type of the system capability to subscribe to</p></dd>
      <dt>observer</dt>
      <dd><p>The object that will have <code>selector</code> called whenever the capability is updated</p></dd>
      <dt>selector</dt>
      <dd><p>The selector on <code>observer</code> that will be called whenever the capability is updated</p></dd>
  </dl>
  <div>
    <h4>Return Value</h4>
    <p>YES if the manager is attempting the subscription, or NO if the manager can&rsquo;t attempt the subscription for some reason (such as the app being in HMI_NONE and the type is not DISPLAYS), or the selector doesn&rsquo;t contain the correct number of parameters.</p>
  </div>
  
  <h3 id="section--unsubscribeFromCapabilityType:withObserver:">
      -unsubscribeFromCapabilityType:withObserver:
  </h3>
  
  <p>Unsubscribe from a particular capability type. If it was subscribed with a block / handler, the return value should be passed to the <code>observer</code> to unsubscribe the block. If it was subscribed with a selector, the <code>observer</code> object (on which the selector exists and is called) should be passed to unsubscribe the object selector.</p>

  
  
  <h4>Objective-C</h4>
  <pre class="highlight objective_c"><code><span class="k">-</span> <span class="p">(</span><span class="kt">void</span><span class="p">)</span><span class="nf">unsubscribeFromCapabilityType</span><span class="p">:(</span><span class="n">nonnull</span> <span class="n"><a href="../Type%20Definitions.html#/c:SDLSystemCapabilityType.h@T@SDLSystemCapabilityType">SDLSystemCapabilityType</a></span><span class="p">)</span><span class="nv">type</span>
                         <span class="nf">withObserver</span><span class="p">:(</span><span class="n">nonnull</span> <span class="n">id</span><span class="p">)</span><span class="nv">observer</span><span class="p">;</span></code></pre>

  
  <h4>Swift</h4>
  <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">unsubscribe</span><span class="p">(</span><span class="n">fromCapabilityType</span> <span class="nv">type</span><span class="p">:</span> <span class="kt"><a href="../Type%20Definitions.html#/c:SDLSystemCapabilityType.h@T@SDLSystemCapabilityType">SDLSystemCapabilityType</a></span><span class="p">,</span> <span class="n">withObserver</span> <span class="nv">observer</span><span class="p">:</span> <span class="kt">Any</span><span class="p">)</span></code></pre>

  
  
  <h4>Parameters</h4>
  <dl>
      <dt>type</dt>
      <dd><p>The type of the system capability to unsubscribe from</p></dd>
      <dt>observer</dt>
      <dd><p>The object that will be unsubscribed. If a block was subscribed, the return value should be passed. If a selector was subscribed, the observer object should be passed.</p></dd>
  </dl>
  
</section>