Table of contents
TOC
Collapse the table of content
Expand the table of content

Video over LTE

Last Updated: 12/12/2016

Partners can customize specific settings and behavior for Video over LTE to meet mobile operator requirements.

These include:

  • Showing or hiding the LTE video calling switch

  • Setting the default value for the switch

  • Customizing the name/label of the switch and the description

  • Specifying the timeout, in milliseconds, for the device to remain in video transition state

  • Enabling video conferencing

  • Specifying the amount of time before a video call is downgraded to a voice call due to low video quality

  • Hiding the video charges dialog that is displayed when the user turns on the LTE video calling switch

Constraints: Some None, some FirstVariationOnly
This customization supports: per-IMSI value

Instructions:

  1. Create a customization answer file using the contents shown in the following code sample.

    <?xml version="1.0" encoding="utf-8" ?>
    <ImageCustomizations xmlns="http://schemas.microsoft.com/embedded/2004/10/ImageUpdate"  
                         Name="VideoOverLTESettings"  
                         Description="Use to customize the settings for Video over LTE."  
                         Owner=""  
                         OwnerType="OEM"> 
    
      <!-- Define the Targets --> 
      <Targets>
         <Target Id="">
            <TargetState>
               <Condition Name="" Value="" />
               <Condition Name="" Value="" />
            </TargetState>
         </Target>
      </Targets>
    
      <Static>
        <Settings Path="Multivariant">
          <Setting Name="Enable" Value="1" />
        </Settings>
    
        <Settings Path="AutoDataConfig">
          <Setting Name="Enable" Value="0" />
        </Settings>
    
        <!-- Add the resource-only dll file and language MUI packages if you are using Windows Phone 8.1 GDR1 and later versions of the OS -->
        <Settings Path="Localization/MUI">  
          <!-- Use to add your base MUI DLL file -->
          <Asset Name="BaseDll" Source="" />
    
          <!-- Use to specify the language MUI packages (*.dll.mui) for the languages you are supporting and have localized strings for -->
          <Asset Name="LanguageDll/$(langid)" Source="" />
          <Asset Name="LanguageDll/$(langid)" Source="" />
          <Asset Name="LanguageDll/$(langid)" Source="" />
          <!-- Add as many as you need -->         
        </Settings>
      </Static>
    
      <!-- Specify the Variant -->
      <Variant Name=""> 
        <TargetRefs>
          <TargetRef Id="" /> 
        </TargetRefs>
    
        <Settings Path="Phone/PerSimSettings/$(__IMSI)">  
          <Setting Name="ShowVideoCallingSwitch" Value="" />
          <Setting Name="DefaultEnableVideoCalling" Value="" /> 
          <Setting Name="DefaultEnableVideoCapability" Value="" />   
          <Setting Name="ShowVideoCapabilitySwitch" Value="" />  
          <Setting Name="AllowVideoConferencing" Value="" />  
          <Setting Name="SupressVideoCallingChargesDialog" Value="" />  
        </Settings>  
    
        <Settings Path="Phone/PhoneSettings">  
          <!-- Note that these settings are FirstVariationOnly -->
    
          <Setting Name="VideoTransitionTimeout" Value="" />
          <Setting Name="VideoCallingLabel" Value="" />
          <Setting Name="VideoCallingDescription" Value="" />
          <Setting Name="LowVideoQualityTimeout" Value="" />
    
          <-- If you enable video conferencing, you can also specify the number of participants that can be added to the conference call -->
          <Setting Name="ConferenceCallMaximumPartyCount" Value="" />
    
        </Settings> 
    
      </Variant>
    
    </ImageCustomizations>
    
  2. Specify an Owner.

  3. Add the resource-only .dll file and the language MUI packages (*.dll.mui) for the languages you are supporting. To do this, follow these steps:

    1. Add the resource-only .dll that contains the custom display string by setting the BaseDll asset to point to the location of your base MUI DLL file. For example: C:\Path\DisplayStrings.dll.

    2. Add the language MUI packages (*.dll.mui) for all the languages you are supporting and have localized strings for. To do this:

      • Set the asset's Name to LanguageDll/$(langid) where $(langid) corresponds to the language. For example: LanguageDll/en-US.

      • Set the asset's Source to the location of the .dll.mui file for that language. For example: C:\Path\en-us\DisplayStrings.dll.mui.

      • Repeat the previous steps for the other languages.

        The following example shows the customization answer file entries for en-US, fr-CA, and es-MX languages:

        <Asset Name="LanguageDll/en-US" Source="C:\Path\en-us\DisplayStrings.dll.mui" />
        <Asset Name="LanguageDll/fr-CA" Source="C:\Path\fr-CA\DisplayStrings.dll.mui" />
        <Asset Name="LanguageDll/es-MX" Source="C:\Path\es-MX\DisplayStrings.dll.mui" />
        

      For more information, see Create a resource-only .dll for localized strings.

  4. Define Targets or conditions for when a variant can be applied, such as keying off a SIM's MCC, MNC, and SPN.

  5. Define settings for a Variant, which are applied if the associated target's conditions are met.

  6. To show or hide the LTE video calling switch, set ShowVideoCallingSwitch to one of the following values:

    ValueDescription

    0 or 'False'

    Hides the LTE video calling switch.

    This is the default OS value.

    1 or 'True'

    Shows the LTE video calling switch.

**Note**  
This setting does not set the default switch value. To do that, set `DefaultEnableVideoCalling`.
  1. To set the initial default value for the LTE video calling switch, set DefaultEnableVideoCalling to one of the following values:

    ValueDescription

    0 or 'False'

    Sets the LTE video calling switch to Off.

    This is the default OS value.

    1 or 'True'

    Sets the LTE video calling switch to On.

  2. To set the initial value for LTE video capability sharing, set DefaultEnableVideoCapability to one of the following values:

    ValueDescription

    0 or 'False'

    Sets the LTE video capability sharing to Off.

    This is the default OS value.

    1 or 'True'

    Sets the LTE video capability sharing to On.

  3. To specify whether to show the video capability sharing switch on the phone Settings screen, set ShowVideoCapabilitySwitch to one of the following values:

    ValueDescription

    0 or 'False'

    Hides the video capability sharing switch.

    This is the default OS value.

    1 or 'True'

    Shows the video capability sharing switch.

  4. To enable LTE video calls to be merged into a conference call, set AllowVideoConferencing to one of the following values:

    ValueDescription

    0 or 'False'

    Disables LTE video calls from being merged into a conference call.

    This is the default OS value.

    1 or 'True'

    Enables LTE video calls to be merged into a conference call.

    If you are enabling LTE video calls, you can also specify the maximum number of participants or callers that can be added to the video conference by setting ConferenceCallMaximumPartyCount. For more information, see Maximum number of participants in a VoLTE conference call.

If this setting is not enabled, the conference option in the UI will never be available. It will always show up as disabled (greyed out).

**Note**  
Video conference support is dependent on support by the mobile operator and the device chipset.
  1. To show or hide the video charges dialog that is displayed when the user turns on the LTE video calling switch, set SupressVideoCallingChargesDialog to one of the following values:

    ValueDescription

    0 or 'False'

    Shows the video calling charges dialog.

    This is the default OS value.

    1 or 'True'

    Hides the video calling charges dialog.

  2. To set the time, in milliseconds, to wait for the response to the request to transition a VoLTE call to video, set VideoTransitionTimeout. You can set the value to a number between 10000 and 30000, inclusive. If you set the value to 0, the OS uses the default value of 30000 (30 seconds).

    An alert tone is played multiple times during this request. Each alert tone will be played in 10 second increments. The number of alert tones is determined by the request time out value divided by 10. For example:

    • If you set the value to 30000 (or 30 seconds), the alert tone will play three times at 0, 10 and 20 seconds, and then 10 seconds later the request will time out.

    • If you set the value to 25000 (or 25 seconds), the alert tone will play three times at 0, 10, and 20 seconds, then 5 seconds later the request will time out.

  3. To customize the name or label of the LTE video calling switch and the description for the switch, set the value for the following settings:

    1. To customize the switch name or label, set the VideoCallingLabel value to the name of the resource-only .dll file and specify the string offset. For example: @DisplayStrings.dll,-101.

      Replace DisplayStrings.dll with the name of your .dll file and replace Offset with the correct offset for the localized string.

    2. To customize the switch description, set the VideoCallingDescription value to the name of the resource-only .dll file and specify the string offset. For example: @DisplayStrings.dll,-102.

      Replace DisplayStrings.dll with the name of your .dll file and replace Offset with the correct offset for the localized string.

  4. To set the timer, in milliseconds, to automatically drop video support from an active video call when the video calling quality is low, set LowVideoQualityTimeout. This will transition the call to a VoLTE call. Set the value to a number between 0 and 120000, inclusive.

    A value of 0 disables the timer. This is also the OS default value.

    Note
    Support for this feature is dependent on support by the mobile operator and the chipset.

Testing:

  1. Flash the build containing this customization to a device.

  2. Go to the Phone settings screen.

  3. Verify whether the switches are visible or the correct settings and values are showing up based on the values you specified for the Video over LTE settings.

  4. If you customized the switch label and description, verify that the correct localized strings are showing up based on the device language.

  5. If the right conditions are met, verify that the timeouts work as expected.

Send comments about this topic to Microsoft

© 2017 Microsoft