Branding for phone calls
Partners can add a custom image that displays the mobile operator name or logo on the Incoming Call screen. This image can be hidden when the device is roaming.
Note that the Call Progress screen, Call History screen, the 12-key dialer, and the phone tile on the Start page display the PLMN string of the mobile operator, but this is not customizable. It is possible to display error messages about the registration status on these components if an invalid UICC is inserted. Alternately, partners can choose to display a longer version of the error messages that includes a reject code.
VoIP applications can also add a custom image that displays the mobile operator name and logo to the Incoming Call screen.
The custom image must meet the following requirements:
40 px high and no more than 180 px wide
White logo – This can contain text or an image, but keep in mind that the image is not localized, and so any text should work regardless of the display language.
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="BrandingForPhoneCalls" Description="Use to add a custom image that displays the mobile operator name or logo on the Incoming Call screen." Owner="" OwnerType="OEM"> <Static> <Settings Path="Phone/BrandingInformation"> <Asset Name="BrandingImages" Source="C:\Path\BrandingImagePhoneScreens.png" /> <Setting Name="CellularBrandingImagePath" Value="BrandingImagePhoneScreens.png" /> <Setting Name="BrandingFlags" Value="" /> </Settings> </Static> </ImageCustomizations>
Add the custom branding image. To do this:
Add an Asset element and set the
Set the asset's Source value to the location and name of the custom .png file. For example: C:\Path\BrandingImagePhoneScreens.png
Set the value of
CellularBrandingImagePathto the name of the custom .png file. For example: BrandingImagePhoneScreens.png
Specify when the branding image should be displayed or display registration status and reject codes in the phone UI by setting the value of
The default value of the
BrandingFlagssetting is 0x000000FB. This value can be replaced by a bit-wise OR of the following flags:
Flag Value Set by default Description
Display the branding image for all non-roaming phone calls.
Do not display the branding image when the phone is roaming.
For markets in which the user must be aware that emergency calls are always permitted, partners can turn on a user notification that emergency calls are still possible even if there is no SIM, the SIM is currently blocked, or the SIM is invalid.
Setting this flag changes the phone branding from SIM state (No SIM, Invalid SIM, PIN required) to emergency possibility state (emergency only versus no service). In the call history page, the progress and dialer where a longer string is possible, the SIM state is appended to the emergency possibility state.
This customization replaces the “No SIM” warning on the phone tile, the call history page, and the dialer with a longer message Emergency only on the phone tile, and No SIM – Emergency calls only on the dialer and call history page.
When the phone does not have a SIM and there is no service, the phone displays No SIM – No Service on the call history, call progress, and the dialer. The phone token shows No service in this scenario.
Display the registration status on different parts of the phone call UI when the operator name is not available because the network cannot be accessed or the SIM is locked or missing.
When the flags are not set, the string Phone is used as the branding text.
Display extended reject codes in error cases such as when the UICC is not provisioned or not allowed.
To fully enable this functionality, you must also configure Extended error messages for reject codes.
Flash a build containing this customization to a phone that contains a UICC, or that is otherwise equipped to receive phone calls.
Depending on the flags you set, verify that the branding image appears appropriately on the Incoming Call screen. The branding image is added as an overlay on top of the contact image.
If you set
DisplayEmergencyCallStatus, verify that the image is visible during emergency calls.
Remove the UICC.
Depending on the flags you set, verify that the registration status appears appropriately on the Call History, Call Progress, and Incoming Call screens, as well as the dialer and the phone tile.
If you set
ExtendedRejectCodes, verify that messages that are displayed to alert the user that they cannot make calls include reject codes. For information about which screens are affected, see Extended error messages for reject codes.