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

Automatically retry downloading MMS messages

Last Updated: 12/12/2016

Partners can configure the messaging app to automatically retry downloading an MMS message if the initial download attempt fails.

When this customization is enabled, the download is retried 3 times at 20-, 40-, and 60-second intervals. The following example shows how the retry intervals work using a random download time:

TimeActivity

00:00:00

Initial download starts

00:00:11

Initial download fails due to a transient error. First wait starts and is scheduled for 20 seconds.

00:00:31

First wait times out, first retry download starts.

00:00:49

First retry download fails due to a transient error. Second wait starts and is scheduled for 40 seconds.

00:01:29

Second wait times out, second retry download starts.

00:01:34

Second retry download fails due to a transient error. Third wait starts and is scheduled for 60 seconds.

00:02:34

Third wait times out, third retry download starts.

If the MMS download fails after the third retry attempt, the message persists in the appropriate thread with a link that the user can tap to retry the download manually. If the user’s manual download attempt fails, the automatic retries are triggered again.

Constraints: None
This customization supports: per-SIM 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="AutoRetryDownloadForMMS"  
                         Description="Use to configure the messaging app to automatically retry downloading an MMS message if the initial download attempt fails."  
                         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>
      </Static>
    
      <!-- Define the Variant -->
      <Variant Name=""> 
        <TargetRefs>
          <TargetRef Id="" /> 
        </TargetRefs>
    
        <Settings Path="Messaging/PerSimSettings/$(__ICCID)">  
          <!-- Set to 1 to enable or 0 to disable -->
          <Setting Name="AutoRetryDownload" Value="" />         
        </Settings>  
    
      </Variant>
    
    </ImageCustomizations>
    
  2. Specify an Owner.

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

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

  5. Set AutoRetryDownload to one of the following values:

    ValueDescription

    1 or 0x1

    Enable automatically retry downloading MMS messages.

    0 or 0x0

    Or if the AutoRetryDownload setting is missing

    Disables automatically retry downloading MMS messages.

Testing steps:

  1. Flash the build containing this customization to a device with a UICC or CDMA connection.

  2. Successfully testing this customization requires the MMS message to fail, so work with mobile operator partner to test this customization on their network.

    Be sure to test the scenario where the automatic retry attempt fails for a third time to verify the appearance of the manual download link.

Send comments about this topic to Microsoft

© 2017 Microsoft