Automatically retry downloading MMS messages
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:
Initial download starts
Initial download fails due to a transient error. First wait starts and is scheduled for 20 seconds.
First wait times out, first retry download starts.
First retry download fails due to a transient error. Second wait starts and is scheduled for 40 seconds.
Second wait times out, second retry download starts.
Second retry download fails due to a transient error. Third wait starts and is scheduled for 60 seconds.
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.
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>
Define Targets or conditions for when a variant can be applied, such as keying off a SIM's MCC, MNC, and SPN.
Define settings for a Variant, which are applied if the associated target's conditions are met.
AutoRetryDownloadto one of the following values:
1 or 0x1
Enable automatically retry downloading MMS messages.
0 or 0x0
Or if the
AutoRetryDownloadsetting is missing
Disables automatically retry downloading MMS messages.
Flash the build containing this customization to a device with a UICC or CDMA connection.
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.