Active phone cover settings

on

Last Updated: 5/9/2017

OEMs can create and register an active phone cover app, which allows partners to create a user experience with their mobile device cover accessories. This app must be preloaded on the phone as a Settings/CPL application.

OEMs can then enable the app to be launched when the active phone cover is closed and specify the default setting for the lock screen's auto unlock setting, which determines if the lock screen is automatically lifted when the user opens the cover.

Limitations and restrictions:

When the OS receives a notification that the cover state has been set to Closed:

  • The OS locks the device.

  • The OS uses the AUMID setting to launch the active phone cover app. The app is launched in the foreground, above the lock screen, and the app is rendered at the top of the z-order.

    • When the OS receives a notification that the cover state has been set to Opened:

  • The OS terminates the active phone cover app and shows the default lock experience.

  • If the user opens the cover and the AutoUnlock setting is set to 1, the OS automatically lifts the lock screen and tries to unlock the device. If the device does not have a password lock, the OS unlocks the device. Otherwise, the OS prompts the user for their password.

    • Constraints: None

    Instructions:

  • 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="SmartCover" Description="Use to preload and configure your active phone cover app." Owner="" OwnerType="OEM"> <Static> <!-- Preload the phone cover app. Specify the source, license, and ProvXML files. --> <Applications> <Application Source="" License="" ProvXML="" /> </Applications> <Settings Path="Shell/SmartCover"> <Setting Name="AUMID" Value="" /> <Setting Name="AutoUnlock" Value="" /> </Settings> </Static> </ImageCustomizations>

  • Specify an Owner.

  • To preload the active phone cover app, add an Applications parent element and add an Application child element to correspond to the active phone cover app that you are preloading. For the Application, specify the values for the following settings:

  • Source – Set to the path and name of the app to preload.

  • License – Set to the path and name of the app license file.

  • ProvXML – Set to the path and name of the provisioning XML file that corresponds to the app.

  • To enable the app to be launched when the cover is closed, set the value of AUMID to your app's Application User Model ID (AUMID). To identify the AUMID, follow the information in this Microsoft Web site. The value must be in the format similar to this example: SmartCoverApp_<PublisherID>!App.

  • To specify the default setting for the lock screen's auto unlock setting and determine if the lock screen is automatically lifted when the user opens the active phone cover, set AutoUnlock to one of the following values:

    0 or 'Disabled'

    The lock screen is not lifted when the user opens the active phone cover.

    1 or 'Enabled'

    The lock screen is automatically lifted when the user opens the active phone cover.

    • Testing steps:

  • Flash the build containing this customization to a phone.

  • Set up the phone and then go to Settings screen. Verify that the active phone cover app appears in the Settings CPL.

  • With the active phone cover attached to the phone, close the cover. Verify that the active phone cover app is launched successfully once the cover is closed.

  • Depending on the value you specified for the AutoUnlock setting, verify whether the lock screen is automatically lifted when you open the active phone cover.

    • Send comments about this topic to Microsoft


    Source: Active phone cover settings

    Comments

    Post a Comment