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

Adding OEM lens apps as options for the default camera

Last Updated: 12/12/2016

OEMs can add lens apps as options for the default camera.

OEMs can add lens apps to be shown in the Pressing the camera button opens screen within the camera's settings CPL. We recommend that OEMs install only up to five (5) lens apps. The lens apps can be preloaded or installed from the Windows Store. When the lens apps are installed on the phone, the apps become available for the user to set as the default camera.

For more information about writing lens apps, see the Windows SDK documentation.

Limitations and restrictions:

  • Partners must not remove or modify any app IDs that Microsoft has configured in the kit. The app IDs added by Microsoft do not count against the number of lens app IDs that partners can add.

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="OEMLensApps"  
                         Description="Use to add lens apps to be shown in the Settings > applications > photos+camera >
                                      Pressing the camera button opens screen."  
                         Owner=""  
                         OwnerType="OEM"> 
    
      <Static>  
    
       <!-- Preload an OEM lens app -->
       <Applications>
          <!-- For each app, specify the source (.xap/.appx), license, and ProvXML files. -->
          <Application Source=""
                       License=""
                       ProvXML="" />
       </Applications>
    
       <!-- Replace $(LensAppGuid) with the app ID of the lens app you want to show in the camera CPL -->
       <Settings Path="Photos/LensApps/$(LensAppGuid)">       
          <!-- Set the value to the friendly name of the OEM lens app -->
          <Setting Name="Title" Value="" />  
       </Settings>  
    
       <!-- You can add up to 5 OEM lens apps to show in the camera CPL
       <Settings Path="Photos/LensApps/$(LensAppGuid)">       
          <Setting Name="Title" Value="" />  
       </Settings> 
    
       <Settings Path="Photos/LensApps/$(LensAppGuid)">       
          <Setting Name="Title" Value="" />  
       </Settings> 
    
       <Settings Path="Photos/LensApps/$(LensAppGuid)">       
          <Setting Name="Title" Value="" />  
       </Settings> 
    
       <Settings Path="Photos/LensApps/$(LensAppGuid)">       
          <Setting Name="Title" Value="" />  
       </Settings> 
       -->
    
      </Static>
    
    </ImageCustomizations>
    
  2. Specify an Owner.

  3. If you are preloading a lens app, add an Applications parent element and add an Application child element to correspond to each lens app that you are preloading. For each Application, specify the Source (.xap/.appx), License, and ProvXML files that correspond to the lens app you are preloading.

  4. To specify the OEM lens app to show in the camera CPL:

    1. Replace $(LensAppGuid) with the app ID of the lens app you want to show in the camera CPL.

    2. Replace Title with the friendly name of the lens app. For example, Contoso Fish Eye Lens.

    3. Specify up to 5 lens apps by creating a registry entry for each as shown in the preceding example. For example, to configure two lens apps to show in the camera CPL, you need to add the following registry entries:

         <Settings Path="Photos/LensApps/{00000000-0000-0000-0000-000000000000}">       
            <Setting Name="Title" Value="Contoso Fish Eye Lens" />  
         </Settings> 
      
         <Settings Path="Photos/LensApps/{00000000-0000-0000-1000-000000000000}">       
            <Setting Name="Title" Value="Contoso Sepia Lens" />  
         </Settings>
      

Testing:

  1. Flash the build containing this customization to a phone.

  2. Install the OEM lens app(s).

  3. Go to the Settings > applications > photos+camera screen and verify that the lens apps that you have specified show up as one of the choices under Pressing the camera button opens.

Send comments about this topic to Microsoft

© 2017 Microsoft