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

Branding for phone calls

Last Updated: 12/12/2016

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:

  • .PNG format

  • 40 px high and no more than 180 px wide

  • Transparent background

  • 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.

Constraints: None

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="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>
    
  2. Specify an Owner.

  3. Add the custom branding image. To do this:

    1. Add an Asset element and set the Name to BrandingImages.

    2. Set the asset's Source value to the location and name of the custom .png file. For example: C:\Path\BrandingImagePhoneScreens.png

  4. Set the value of CellularBrandingImagePath to the name of the custom .png file. For example: BrandingImagePhoneScreens.png

  5. Specify when the branding image should be displayed or display registration status and reject codes in the phone UI by setting the value of BrandingFlags.

    The default value of the BrandingFlags setting is 0x000000FB. This value can be replaced by a bit-wise OR of the following flags:

    FlagValueSet by defaultDescription

    ShowBrandingImage

    0x00000001

    Yes

    Display the branding image for all non-roaming phone calls.

    HideBrandingImageOnRoam

    0x00000002

    Yes

    Do not display the branding image when the phone is roaming.

    DisplayEmergencyCallStatus

    0x00000004

    No

    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.

    ShowRegistrationStatusInCallHistory

    ShowRegistrationStatusInCallProgress

    ShowRegistrationStatusInDialer

    ShowRegistrationStatusInIncomingCall

    ShowRegistrationStatusInPhoneToken

    0x00000008

    0x00000010

    0x00000020

    0x00000040

    0x00000080

    Yes

    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.

    ExtendedRejectCodes

    0x00000100

    No

    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.

Testing steps:

  1. Flash a build containing this customization to a phone that contains a UICC, or that is otherwise equipped to receive phone calls.

  2. 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.

  3. If you set DisplayEmergencyCallStatus, verify that the image is visible during emergency calls.

  4. Remove the UICC.

  5. 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.

  6. 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.

Send comments about this topic to Microsoft

© 2017 Microsoft