應用程式功能宣告App capability declarations

必須在 Windows 應用程式的封裝資訊清單中宣告功能,才能存取特定 Windows 10 API 或資源 (如圖片、音樂),或是相機或麥克風等裝置。Capabilities must be declared in your Windows app's package manifest to access certain Windows 10 APIs or resources, such as pictures, music, or devices such as the camera or the microphone. UWP 應用程式以及其他類型的傳統型應用程式 (封裝在 Windows 10 的 MSIX 或 AppX 套件中) 會使用功能。Capabilities are used by UWP apps as well as other types of desktop apps that are packaged in an MSIX or AppX package for Windows 10.

您可以藉由在 app 的套件資訊清單中宣告功能,來要求存取特定資源或 API。You request access to specific resources or API by declaring capabilities in your app's package manifest. 您可以使用 Visual Studio 中的資訊清單設計工具來宣告一般的功能,也可以手動新增。You can declare general capabilities by using the Manifest Designer in Visual Studio, or you can add them manually. 如需詳細資訊,請參閱如何在套件資訊清單中指定功能For more information, see How to specify capabilities in a package manifest. 請務必了解,當客戶從市集取得您的 app 時,會得知該 app 宣告的所有功能。It is important to know that when customers get your app from the Store, they're notified of all the capabilities that the app declares. 因此,請避免宣告您的 app 不需要的功能。Avoid declaring capabilities that your app doesn't need.

部分功能提供 app 存取 敏感資源 的權限。Some capabilities provide apps with access to a sensitive resource. 這些資源會視為敏感資源是因為它們可以存取使用者的個人資料或使用者必須付費才能使用。These resources are considered sensitive because they can access the user's personal data or cost the user money. 受設定 app 管理的隱私權設定可讓使用者動態控制敏感資源的存取權。Privacy settings, managed by the Settings app, let the user dynamically control access to sensitive resources. 因此,您的 app 不會假設敏感資源可隨時使用這點非常重要。Thus, it's important that your app doesn't assume a sensitive resource is always available. 如需存取敏感資源的詳細資訊,請參閱隱私權感知 app 的指導方針For more info about accessing sensitive resources, see Guidelines for privacy-aware apps. 提供應用程式「敏感資源」存取權的功能,於功能案例旁邊會加註星號 (*)。Capabilities that provide apps with access to a sensitive resource are annotated by an asterisk (*) next to the capability scenario.

有數種類型的功能。There are several types of capabilities.

一般用途功能General-use capabilities

一般用途功能是使用應用程式封裝資訊清單中的 Capability 元素來指定。General-use capabilities are specified by using Capability elements in your app package manifest. 這些功能適用於大部分常見的應用程式案例。These capabilities apply to the most common app scenarios.

注意

在封裝資訊清單中的 Capabilities 節點底下,所有的 Capability 元素都必須放在任何 CustomCapabilityDeviceCapability 元素之前。All Capability elements must come before any CustomCapability and DeviceCapability elements under the Capabilities node in the package manifest.

功能案例Capability scenario 功能使用方式Capability usage
音樂*Music* musicLibrary 功能提供對使用者 [音樂] 媒體櫃的程式化存取,可讓應用程式列舉及存取媒體櫃中的所有檔案,而不需使用者互動。The musicLibrary capability provides programmatic access to the user's Music library, allowing the app to enumerate and access all files in the library without user interaction. 這個功能通常用於點唱機 app,這類 app 需要存取整個 [音樂] 媒體櫃。This capability is typically used in jukebox apps that make use of the entire Music library.

檔案選擇器提供健全的 UI 機制,讓使用者可開啟要供 app 使用的檔案。The file picker provides a robust UI mechanism that lets users open files for use with an app. 只有當您 app 的案例需要以程式設計方式進行存取,而您無法使用檔案選擇器來實現時,才需宣告 musicLibrary 功能。Declare the musicLibrary capability only when the scenarios for your app require programmatic access and can't be realized by using the file picker.

在您的 app 套件資訊清單中宣告 musicLibrary 功能時,它必須包含 uap 命名空間,如下所示。The musicLibrary capability must include the uap namespace when you declare it in your app's package manifest as shown below.

<Capabilities><uap:Capability Name="musicLibrary"/></Capabilities>
圖片*Pictures* picturesLibrary 功能提供對使用者 [圖片] 庫的程式化存取,可讓應用程式列舉及存取媒體櫃中的所有檔案,而不需使用者互動。The picturesLibrary capability provides programmatic access to the user's Pictures library, allowing the app to enumerate and access all files in the library without user interaction. 這個功能通常用於相片 app,這類 app 需要存取整個 [圖片] 媒體櫃。This capability is typically used in photo apps that make use of the entire Pictures library.

檔案選擇器提供健全的 UI 機制,讓使用者可開啟要供 app 使用的檔案。The file picker provides a robust UI mechanism that lets users open files for use with an app. 只有當您 app 的案例需要以程式設計方式進行存取,而您無法使用檔案選擇器來實現時,才需宣告 picturesLibrary 功能。Declare the picturesLibrary capability only when the scenarios for your app require programmatic access and can't be realized them by using the file picker.

在您的 app 套件資訊清單中宣告 picturesLibrary 功能時,它必須包含 uap 命名空間,如下所示。The picturesLibrary capability must include the uap namespace when you declare it in your app's package manifest as shown below.

<Capabilities><uap:Capability Name="picturesLibrary"/></Capabilities>
視訊*Videos* videosLibrary 功能提供以程式設計方式存取使用者的 [影片],允許 app 在沒有使用者互動的情況下,列舉和存取媒體櫃中的所有檔案。The videosLibrary capability provides programmatic access to the user's Videos, allowing the app to enumerate and access all files in the library without user interaction. 這個功能通常用於電影播放 app,這類 app 需要存取整個 [影片] 媒體櫃。This capability is typically used in movie-playback apps that make use of the entire Videos library.

檔案選擇器提供健全的 UI 機制,讓使用者可開啟要供 app 使用的檔案。The file picker provides a robust UI mechanism that lets users open files for use with an app. 只有當您 app 的案例需要以程式設計方式進行存取,而您無法使用檔案選擇器來實現時,才需宣告 videosLibrary 功能。Declare the videosLibrary capability only when the scenarios for your app require programmatic access and can't be realized by using the file picker.

在您的 app 套件資訊清單中宣告 videosLibrary 功能時,它必須包含 uap 命名空間,如下所示。The videosLibrary capability must include the uap namespace when you declare it in your app's package manifest as shown below.

<Capabilities><uap:Capability Name="videosLibrary"/></Capabilities>
卸除式存放裝置Removable Storage removableStorage 功能提供以程式設計方式存取抽取式存放裝置 (例如 USB 快閃磁碟機和外接式硬碟) 中的檔案 (已篩選出套件資訊清單中宣告的檔案類型關聯) 的功能。The removableStorage capability provides programmatic access to files on removable storage, like USB keys and external hard drives, filtered to the file-type associations declared in the package manifest. 例如,如果文件閱讀程式 app 宣告 .doc 檔案類型關聯,則可以開啟抽取式存放裝置上的 .doc 檔案,但不能開啟其他類型的檔案。For example, if a document-reader app declares a .doc file-type association, it can open .doc files on the removable storage device, but not other types of files. 宣告這個功能時請小心,因為使用者可能會在他們的抽取式存放裝置上包含各種不同資訊,而且會預期您的 app 會針對以程式設計方式存取抽取式存放裝置上所有宣告的檔案類型提供有效的調整。Be careful when you declare this capability, because users may include a variety of info in their removable storage devices, and will expect your app to provide a valid justification for programmatic access to the removable storage for all files of the declared type.

使用者會預期您的 app 會處理宣告的所有檔案關聯。Users will expect your app to handle any file associations that you declare. 因此,請勿宣告您的 app 無法負責處理的檔案關聯。So don't declare file associations that your app cannot handle responsibly. 檔案選擇器提供健全的 UI 機制,讓使用者可開啟要供 app 使用的檔案。The file picker provides a robust UI mechanism that lets users open files for use with an app.

只有當您 app 的案例需要以程式設計方式進行存取,而您無法使用 檔案選擇器來實現時,才需宣告 removableStorage 功能。Declare the removableStorage capability only when the scenarios for your app require programmatic access and can't be realized by using the file picker.

在您的 app 套件資訊清單中宣告 removableStorage 功能時,它必須包含 uap 命名空間,如下所示。The removableStorage capability must include the uap namespace when you declare it in your app's package manifest as shown below.

<Capabilities><uap:Capability Name="removableStorage"/></Capabilities>
網際網路和公用網路*Internet and public networks* 有兩個功能可以提供不同等級的網際網路和公用網路存取權。There are two capabilities that provide different levels of access to the Internet and public networks.

internetClient 功能指出 app 可接收從網際網路傳入的資料。The internetClient capability indicates that apps can receive incoming data from the Internet. 無法做為伺服器。Cannot act as a server. 不具區域網路存取權。No local network access.
internetClientServer 功能指出 app 可接收從網際網路傳入的資料。The internetClientServer capability indicates that apps can receive incoming data from the Internet. 可以做為伺服器。Can act as a server. 不具區域網路存取權。No local network access.

大部分含有 Web 服務元件的 app 都將使用 internetClientMost apps that have a web service component will use internetClient. 啟用點對點 (P2P) 案例的 app (此 app 需要接聽連入的網路連線) 應該使用 internetClientServerApps that enable peer-to-peer (P2P) scenarios where the app needs to listen for incoming network connections should use internetClientServer. internetClientServer 功能包含 internetClient 功能提供的存取權,因此指定 internetClientServer 就不需要指定 internetClientThe internetClientServer capability includes the access that the internetClient capability provides, so you don't need to specify internetClient when you specify internetClientServer.
家用與工作場所網路*Homes and work networks* privateNetworkClientServer 功能可以透過防火牆,提供家用與工作場所網路的對內和對外存取。The privateNetworkClientServer capability provides inbound and outbound access to home and work networks through the firewall. 這個功能通常用於透過區域網路 (LAN) 通訊的遊戲,或在各種本機裝置上共用資料的 app。This capability is typically used for games that communicate across the local area network (LAN), and for apps that share data across a variety of local devices. 如果 app 指定 musicLibrarypicturesLibraryvideosLibrary,則您不需使用這個功能來存取家用群組中對應的媒體櫃。If your app specifies musicLibrary, picturesLibrary, or videosLibrary, you don't need to use this capability to access the corresponding library in a Home Group. 在 Windows 上,這個功能不提供網際網路的存取權。On Windows, this capability does not provide access to the Internet.
約會Appointments appointments 功能可提供存取使用者的約會存放區。The appointments capability provides access to the user's appointment store. 這個功能提供從已同步網路帳戶取得之約會和其他寫入約會存放區之 app 的讀取權限。This capability allows read access to appointments obtained from the synced network accounts and to other apps that write to the appointment store. 有了這個功能,您的 app 就可以建立新的行事曆,以及將約會寫入建立的行事曆中。With this capability, your app can create new calendars and write appointments to calendars that it creates.

在您的 app 套件資訊清單中宣告 appointments 功能時,它必須包含 uap 命名空間,如下所示。The appointments capability must include the uap namespace when you declare it in your app's package manifest as shown below.

<Capabilities><uap:Capability Name="appointments"/></Capabilities>
連絡人*Contacts* contacts 功能可存取來自各個連絡人存放區的連絡人彙總檢視。The contacts capability provides access to the aggregated view of the contacts from various contacts stores. 這個功能提供 app 有限的存取權 (套用網路許可規則),讓 app 存取與各種網路同步的連絡人和本機連絡人存放區。This capability gives the app limited access (network permitting rules apply) to contacts that were synced from various networks and the local contact store.

在您的 app 套件資訊清單中宣告 contacts 功能時,它必須包含 uap 命名空間,如下所示。The contacts capability must include the uap namespace when you declare it in your app's package manifest as shown below.

<Capabilities><uap:Capability Name="contacts"/></Capabilities>
程式碼產生Code generation codeGeneration 功能讓 App 能夠存取下列函式,以提供 JIT 功能給 App。The codeGeneration capability allows apps to access the following functions which provide JIT capabilities to apps.

VirtualProtectFromAppVirtualProtectFromApp
CreateFileMappingFromAppCreateFileMappingFromApp
OpenFileMappingFromAppOpenFileMappingFromApp
MapViewOfFileFromAppMapViewOfFileFromApp
AllJoynAllJoyn allJoyn 功能讓網路上具備 AllJoyn 功能的 app 和裝置能夠進行探索且與彼此互動。The allJoyn capability allows AllJoyn-enabled apps and devices on a network to discover and interact with each other.

存取 Windows.Devices.AllJoyn 命名空間中之 API 的所有 app 都必須使用這個功能。All apps that access APIs in the Windows.Devices.AllJoyn namespace must use this capability.
通話Phone calls phoneCall 功能讓 app 能夠存取裝置上的所有電話線路,並執行下列功能。The phoneCall capability allows apps to access all of the phone lines on the device and perform the following functions.
  • 在不提示使用者的情況下,透過該電話線路撥打電話,並顯示系統撥號程式。Place a call on the phone line and show the system dialer without prompting the user.
  • 存取與線路相關的中繼資料。Access line-related metadata.
  • 存取與線路相關的觸發程序。Access line-related triggers.
  • 讓使用者選取的垃圾電話篩選 app 能夠設定和檢查封鎖清單及通話來源資訊。Allows the user-selected spam filter app to set and check block list and call origin information.
在您的 app 套件資訊清單中宣告 phoneCall 功能時,它必須包含 uap 命名空間,如下所示。The phoneCall capability must include the uap namespace when you declare it in your app's package manifest as shown below.

<Capabilities><uap:Capability Name="phoneCall"/></Capabilities>

phoneCallHistoryPublic 功能讓應用程式能夠讀取行動電話和該裝置上的一些 VoIP 通話歷程記錄資訊。The phoneCallHistoryPublic capability allows apps to read cellular and some VoIP call history information on the device. 這個功能也可讓應用程式寫入 VoIP 通話歷程記錄項目。This capability also allows the app to write VoIP call history entries. 要存取 PhoneCallHistoryStore 類別的所有成員,必須要有這個功能。This capability is required to access all members of the PhoneCallHistoryStore class.
錄製的通話資料夾*Recorded Calls Folder* recordedCallsFolder 裝置功能讓 app 能夠存取錄製的通話資料夾。The recordedCallsFolder device capability allows apps to access the recorded calls folder.

在您的 app 套件資訊清單中宣告 recordedCallsFolder 功能時,它必須包含 mobile 命名空間,如下所示。The recordedCallsFolder capability must include the mobile namespace when you declare it in your app's package manifest as shown below.

<Capabilities><mobile:Capability Name="recordedCallsFolder"/></Capabilities>
使用者帳戶資訊*User Account Information* userAccountInformation 功能讓 app 能夠存取使用者的名稱和圖片。The userAccountInformation capability gives apps the ability to access the user's name and picture.

您需要具備這個功能,才能存取 Windows.System.UserProfile 命名空間中的某些 API。This capability is required to access some APIs in the Windows.System.UserProfile namespace.

在您的 app 套件資訊清單中宣告 userAccountInformation 功能時,它必須包含 uap 命名空間,如下所示。The userAccountInformation capability must include the uap namespace when you declare it in your app's package manifest as shown below.

<Capabilities><uap:Capability Name="userAccountInformation"/></Capabilities>
VoIP 通話VoIP calling voipCall 功能讓應用程式能夠存取 Windows.ApplicationModel.Calls 命名空間中的 VoIP 通話 API。The voipCall capability allows apps to access the VoIP calling APIs in the Windows.ApplicationModel.Calls namespace.

在您的 app 套件資訊清單中宣告 voipCall 功能時,它必須包含 uap 命名空間,如下所示。The voipCall capability must include the uap namespace when you declare it in your app's package manifest as shown below.

<Capabilities><uap:Capability Name="voipCall"/></Capabilities>
3D 物件3D Objects objects3D 功能讓 app 能以程式設計的方式存取 3D 物件檔案。The objects3D capability allows apps to have programmatic access to the 3D object files. 這項功能通常用於必須存取整個 3D 物件庫的 3D 應用程式和遊戲。This capability is typically used in 3D apps and games that need access to the entire 3D objects library.

需要具備這個功能,才能使用 Windows.Storage 命名空間中的 API 存取包含 3D 物件的資料夾。This capability is required to access the folder that contains the 3D objects using APIs in the Windows.Storage namespace.

在您的 app 套件資訊清單中宣告 objects3D 功能時,它必須包含 uap 命名空間,如下所示。The objects3D capability must include the uap namespace when you declare it in your app's package manifest as shown below.

<Capabilities><uap:Capability Name="objects3D"/></Capabilities>
讀取已封鎖訊息*Read Blocked Messages* blockedChatMessages 功能讓 app 能夠讀取已由垃圾郵件篩選 app 封鎖的簡訊和多媒體簡訊訊息。The blockedChatMessages capability allows apps to read SMS and MMS messages that have been blocked by the Spam Filter app.

需要具備這個功能,才能使用 Windows.ApplicationModel.Chat 命名空間中的 API 存取已封鎖的訊息。This capability is required to access the blocked messages using APIs in the Windows.ApplicationModel.Chat namespace.

在您的 app 套件資訊清單中宣告 blockedChatMessages 功能時,它必須包含 uap 命名空間,如下所示。The blockedChatMessages capability must include the uap namespace when you declare it in your app's package manifest as shown below.

<Capabilities><uap:Capability Name="blockedChatMessages"/></Capabilities>
自訂裝置Custom Devices 在達到一些額外的要求時,lowLevelDevices 功能可讓應用程式存取自訂裝置。The lowLevelDevices capability allows apps to access custom devices when a number of additional requirements are met. 這項功能不應與 lowLevel 裝置功能混淆,後者可讓您存取 GPIO、I2C、SPI、PWM 裝置。This capability should not be confused with the lowLevel device capability, which allows access to GPIO, I2C, SPI, and PWM devices.

如果您開發的自訂驅動程式會公開 裝置介面,而且您想要開啟此裝置的控制代碼並傳送 IOCTL,您必須:If you develop a custom driver that exposes a device interface and you wish to open a handle to this device and send IOCTLs, you must: 然後,您可以使用 Windows.Devices.Custom.CustomDevice 開啟裝置的控制代碼。You can then use Windows.Devices.Custom.CustomDevice to open a handle to your device. 如需詳細資訊,請參閱適用於內部裝置的 UWP 裝置應用程式For more information, see UWP device apps for internal devices.
IoT 系統管理IoT System Administration systemManagement 功能讓 app 具備基本的系統管理權限,例如關機或重新啟動、地區設定和時區。The systemManagement capability allows apps to have basic system administration privileges such as shutting down or rebooting, locale, and timezone.

需要具備這個功能,才能存取 Windows.System 命名空間中的某些 API。This capability is required to access some of the APIs in the Windows.System namespace.

在您的 app 套件資訊清單中宣告 systemManagement 功能時,它必須包含 iot 命名空間,如下所示。The systemManagement capability must include the iot namespace when you declare it in your app's package manifest as shown below.

<Capabilities><iot:Capability Name="systemManagement"/></Capabilities>
背景媒體播放Background Media Playback backgroundMediaPlayback 功能會變更媒體特定 API (例如 MediaPlayerAudioGraph 類別) 的行為,以便在您的 app 位於背景時啟用媒體播放。The backgroundMediaPlayback capability changes the behavior of the media-specific APIs like the MediaPlayer and AudioGraph classes to enable media playback while your app is in the background. 所有作用中的音訊資料流將不再設為靜音,但在 app 轉換到背景時仍可繼續聽到聲音。All active audio streams will no longer mute, but will continue to be audible when an app transitions to the background. 此外,進行播放時,將會自動延伸應用程式存留期。Additionally, app lifetime will be extended automatically while playback is occurring.
遠端系統Remote System remoteSystem 功能讓 app 能夠存取與使用者 Microsoft 帳戶相關聯的裝置清單。The remoteSystem capability allows apps to have access to a list of devices associated with the user's Microsoft Account. 需要存取裝置清單,才能執行任何保留在裝置上的操作。Access to the device list is necessary to perform any operations that persist across devices. 需要具備這個功能,才能存取下列各項的所有成員。This capability is required to access to all members of the following.
空間感知Spatial Perception spatialPerception 功能提供空間對應資料的程式設計存取,並提供有關使用者附近空間的應用程式指定區域中表面的混合實境應用程式資訊。The spatialPerception capability provides programmatic access to spatial mapping data, giving mixed reality apps information about surfaces in application-specified regions of space near the user. 只有在應用程式明確使用這些表面網格時,才要宣告 spatialPerception 功能,因為混合實境應用程式根據使用者頭部姿勢執行全像轉譯時並不需要此功能。Declare the spatialPerception capability only when your app will explicitly use these surface meshes, as the capability is not required for mixed reality apps to perform holographic rendering based on the user's head pose.
全域媒體控制Global Media Control globalMediaControl 功能可讓應用程式存取整個系統中與 SystemMediaTransportControls 整合的播放會話,以提供播放資訊並允許遠端控制。The globalMediaControl capability allows apps to access to playback sessions throughout the system that have integrated with SystemMediaTransportControls to provide playback info and allow remote control. 需要具備這個功能,才能使用 Windows.Media.Control 命名空間中的某些 API。This capability is required to use some APIs in the Windows.Media.Control namespace. 這項功能是在 uap7:Capability 元素中定義。This capability is defined in the uap7:Capability element.

裝置功能Device capabilities

裝置功能可以讓您的 app 存取周邊和內部裝置。Device capabilities allow your app to access peripheral and internal devices. 裝置功能是使用應用程式套件資訊清單中的 DeviceCapability 元素來指定。Device capabilities are specified by using DeviceCapability elements in your app package manifest. 這個元素可能需要其他子元素,而且您必須手動將一些裝置功能新增到套件資訊清單。This element may require additional child elements and some device capabilities need to be added to the package manifest manually. 如需詳細資訊,請參閱 如何在套件資訊清單中指定裝置功能DeviceCapability 結構描述參考For more info, see How to specify device capabilities in a package manifest and DeviceCapability Schema reference.

注意

封裝資訊清單中的 Capabilities 元素下,您可以有多個 DeviceCapability 元素。You can have multiple DeviceCapability elements under the Capabilities element in the package manifest. 所有 DeviceCapability 元素都必須在任何 CapabilityCustomCapability 元素之後。All DeviceCapability elements must come after any Capability and CustomCapability elements.

功能案例Capability scenario 功能使用方式Capability usage
位置*Location* location 功能提供存取位置功能,您可以透過專用硬體 (例如電腦中的 GPS 感應器) 來擷取這類功能,或是從可用的網路資訊加以衍生。The location capability provides access to location functionality that is retrieved from dedicated hardware like a GPS sensor in the PC or is derived from available network info. 當使用者從設定常用鍵停用定位服務時,app 必須能夠處理這種狀況。Apps must handle the case in which the user has disabled location services from the Settings charm.
麥克風Microphone microphone 功能提供存取麥克風的音訊饋送,讓 app 能夠從連接的麥克風錄音。The microphone capability provides access to the microphone's audio feed, which allows the app to record audio from connected microphones. 當使用者從設定常用鍵停用麥克風時,app 必須能夠處理這種狀況。Apps must handle the case in which the user has disabled the microphone from the Settings charm.
接近Proximity proximity 功能可以讓多個近接的裝置彼此通訊。The proximity capability enables multiple devices in close proximity to communicate with one another. 這個功能通常用於輕鬆的多人遊戲,以及交換資訊的 app 中。This capability is typically used in casual multi-player games and in apps that exchange information. 裝置會試著使用提供最佳連線的通訊技術,例如藍牙、Wi-Fi 以及網際網路。Devices attempt to use the communication technology that provides the best possible connection, including Bluetooth, Wi-Fi, and the Internet. 這個功能只能用於起始裝置間的通訊。This capability is used only to initiate communication between the devices.
網路攝影機Webcam webcam 功能提供存取內建相機或外接式網路攝影機的視訊饋送,讓 app 能夠擷取相片和影片。The webcam capability provides access to the video feed of a built-in camera or external webcam, which allows the app to capture photos and videos. 在 Windows 上,當使用者從設定常用鍵停用相機時,app 必須能夠處理這種狀況。On Windows, apps must handle the case in which the user has disabled the camera from the Settings charm.
webcam 功能只授與對視訊串流的存取權。The webcam capability only grants access to the video stream. 若要同時授與對音訊串流的存取權,必須新增 microphone 功能。In order to grant access to the audio stream as well, the microphone capability must be added.
USBUSB usb 裝置功能可讓您存取 針對 USB 裝置更新應用程式資訊清單套件中所述的 API。The usb device capability enables access to APIs in the Updating the app manifest package for a USB device.
人性化介面裝置 (HID)Human interface device (HID) humaninterfacedevice 裝置功能可讓您存取 如何指定 HID 的裝置功能中的 API。The humaninterfacedevice device capability enables access to APIs in the How to specify device capabilities for HID.
服務點 (POS)Point of Service (POS) pointOfService 裝置功能可讓您存取 Windows.Devices.PointOfService 命名空間中的 API。The pointOfService device capability enables access to APIs in the Windows.Devices.PointOfService namespace. 這個命名空間可以讓您的 app 存取服務指標 (POS) 條碼掃描器和磁條讀取器。This namespace lets your app access Point of Service (POS) barcode scanners and magnetic stripe readers. 這個命名空間提供一個廠商中性介面,可讓您從 UWP 應用程式存取來自各個製造商的 POS 裝置。The namespace provides a vendor-neutral interface for accessing POS devices from various manufacturers from a UWP app.
BluetoothBluetooth bluetooth 裝置功能讓 app 能夠與兩個都透過 Generic Attribute (GATT) 或 Classic Basic Rate (RFCOMM) 通訊協定且配對好的藍牙裝置通訊。The bluetooth device capability allows apps to communicate with already paired bluetooth devices over both Generic Attribute (GATT) or Classic Basic Rate (RFCOMM) protocol.
需要具備這個功能,才能使用 Windows.Devices.Bluetooth 命名空間中的某些 API。This capability is required to use some APIs in the Windows.Devices.Bluetooth namespace.
Wi-Fi 網路功能Wi-Fi Networking wiFiControl 裝置功能讓 app 能夠掃描並連線到 Wi-Fi 網路。The wiFiControl device capability allows apps to scan and connect to Wi-Fi networks.
需要具備這個功能,才能使用 Windows.Devices.WiFi 命名空間中的某些 API。This capability is required to use some APIs in the Windows.Devices.WiFi namespace.
無線電狀態Radio state radios 裝置功能讓 app 能夠在 Wi-Fi 和藍牙無線電之間切換。The radios device capability allows apps to toggle the Wi-Fi and Bluetooth radios.
需要具備這個功能,才能使用 Windows.Devices.Radios 命名空間中的 API。This capability is required to use the APIs in the Windows.Devices.Radios namespace.
光碟片Optical disc optical 裝置功能讓 app 能夠存取光碟機 (例如 CD、DVD 及藍光) 上的功能。The optical device capability allows apps to access functions on optical disk drives such as CD, DVD, and Blu-ray.
需要具備這個功能,才能使用 Windows.Devices.Custom 命名空間中的某些 API。This capability is required to use some APIs in the Windows.Devices.Custom namespace.
動作活動Motion activity activity 裝置功能讓 app 能夠偵測裝置目前的動作。The activity device capability allows apps to detect the current motion of the device.
需要具備這個功能,才能使用 Windows.Devices.Sensors 命名空間中的某些 API。This capability is required to use some APIs in the Windows.Devices.Sensors namespace.
序列通訊Serial communication Serialcommunication 裝置功能提供 Windows.Devices.SerialCommunication 命名空間中 API 的存取權,可讓 Windows 應用程式與公開序列埠或序列埠部分抽象概念的裝置進行通訊。The serialcommunication device capability provides access to APIs in the Windows.Devices.SerialCommunication namespace, which allows a Windows app to communicate with a device that exposes a serial port or some abstraction of a serial port. 需要具備這個功能,才能使用 Windows.Devices.SerialCommnication 命名空間中的 API。This capability is required to use the APIs in the Windows.Devices.SerialCommnication namespace.
眼動追蹤儀Eye Tracker 相容眼球追蹤裝置已連線時,或對於支援注視追蹤的混合實境裝置,gazeInput 功能可讓應用程式偵測使用者在應用程式範圍內注視的位置。The gazeInput capability allows apps to detect where the user is looking within the application bounds when a compatible eye tracking device is connected or for Mixed Reality devices that support gaze tracking. 需要具備這個功能,才能使用 Windows.Devices.Input.Preview 命名空間中的某些 API。This capability is required to use some APIs in the Windows.Devices.Input.Preview namespace. 對於混合實境裝置,Windows.Perception.People.EyesPose 中的 API 需要這項功能。For Mixed Reality devices, this capability is required for APIs in the Windows.Perception.People.EyesPose.
GPIO、I2C、SPI、PWMGPIO, I2C, SPI, and PWM lowLevel 裝置功能可讓您存取 GPIO、I2C、SPI、PWM 裝置。The lowLevel device capability provides access to GPIO, I2C, SPI, and PWM devices. 若要在下列命名空間中使用 API,這項功能是必要的:Windows.Devices.GpioWindows.Devices.I2cWindows.Devices.SpiWindows.Devices.PwmThis capability is required to use the APIs in the following namespaces: Windows.Devices.Gpio, Windows.Devices.I2c, Windows.Devices.Spi,Windows.Devices.Pwm.

<Capabilities><DeviceCapability Name="lowLevel"/></Capabilities>

受限功能Restricted capabilities

如果您的應用程式宣告任何受限制的功能,您必須在應用程式提交程序期間提供資訊,才能獲准將應用程式發佈至 Microsoft Store。If your app declares any restricted capabilities, you must provide info during the app submission process in order to be approved to publish the app to the Microsoft Store. 您可以在提交的 提交選項 頁面上提供這項資訊,說明您的應用程式如何使用它所宣告的每個受限功能。You provide this info on the Submission options page of your submission, explaining how your app uses each restricted capability that it declares.

重要

受限功能適用於非常特殊的情況。Restricted capabilities are intended for very specific scenarios. 這些功能的用法受到高度限制,而且受其他市集上架原則和審查規定的規範。The use of these capabilities is highly restricted and subject to additional Store onboarding policy and review. 請注意,您可以在不需要收到任何核准的情形下側載有宣告受限功能的應用程式。Note that you can sideload apps that declare restricted capabilities without needing to receive any approval. 只有在將這些應用程式提交到 Microsoft Store 時才需要核准。Approval is only required when submitting these apps to the Store.

除非您的應用程式真正需要,否則請務必不要宣告這些受限功能。Be sure not to declare these restricted capabilities unless your app truly needs them. 這類功能在某些情況下是必要且適當的,例如具備雙因素驗證的銀行系統,使用者需提供含數位憑證的智慧卡來確認身分識別。There are cases where such capabilities are necessary and appropriate, such as banking with two-factor authentication, where users provide a smart card with a digital certificate that confirms their identity. 其他應用程式主要可能是針對企業客戶所設計,而且可能需要存取公司資源,若使用者沒有網域認證,便無法存取這類公司資源。Other apps may be designed primarily for enterprise customers and may need access to corporate resources that cannot be accessed without the user's domain credentials.

若要宣告受限功能,請修改您的應用程式封裝資訊清單來源檔案 (Package.appxmanifest)。To declare a restricted capability, modify your app package manifest source file (Package.appxmanifest). 新增 xmlns:rescap XML 命名空間宣告,並在宣告受限功能時使用 rescap 前置詞。Add the xmlns:rescap XML namespace declaration, and use the rescap prefix when you declare your restricted capability. 例如,以下示範如何宣告 appCaptureSettings 功能。For example, here's how to declare the appCaptureSettings capability.

<?xml version="1.0" encoding="utf-8"?>
<Package
    ...
    xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities"
    IgnorableNamespaces="... rescap">
...
<Capabilities>
    <rescap:Capability Name="appCaptureSettings"/>
</Capabilities>
</Package>

注意

在封裝資訊清單中的 Capabilities 節點底下,所有的受限功能元素都必須放在任何 CustomCapabilityDeviceCapability 元素之前。All restricted capability elements must come before any CustomCapability and DeviceCapability elements under the Capabilities node in the package manifest.

受限功能核准程序Restricted capability approval process

在過去,我們要求您連絡支援服務以取得使用功能的核准。Previously, we required you to contact support to get approval to use a capability. 我們現在可讓您在合作夥伴中心中提供這項資訊,作為提交程序的一部分。We now allow you to provide this info in Partner Center as part of the submission process.

當您上傳要提交的套件時,我們將偵測是否有宣告受限功能。When you upload packages for your submission, we will detect whether any restricted capabilities are declared. 如果我們這樣做,您將需要在提交選項頁面提供有關您的產品如何使用每項功能的詳細資訊。If we do so, you will be required to provide details about how your product uses each capability on the Submission options page. 請務必提供詳細資料以協助我們了解您的產品需要宣告該功能的原因。Be sure to provide as much detail as possible to help us understand why your product needs to declare the capability. 請注意,應用程式提交可能需要更多時間來完成認證程序。Note that this may add some additional time for your submission to complete the certification process.

認證過程中,我們的測試人員將會檢閱您所提供的資訊,以判斷是否核准您提交的應用程式使用該功能。During the certification process, our testers will review the info you provide to determine whether your submission is approved to use the capability. 請注意,應用程式提交可能需要更多時間來完成認證程序。Note that this may add some additional time for your submission to complete the certification process. 如果我們核准您使用此功能,您的應用程式將繼續進行認證程序的其餘部分。If we approve your use of the capability, your app will continue through the rest of the certification process. 當您提交應用程式的更新時,通常不必重複功能核准程序 (除非您宣告其他功能)。You generally will not have to repeat the capability approval process when you submit updates to your app (unless you declare additional capabilities).

如果我們不核准您使用此功能,您的提交無法通過認證,而且我們將會在認證報告中提供意見反應。If we don't approve your use of the capability, your submission will fail certification, and we will provide feedback in the certification report. 然後,您可以選擇建立新的提交和上傳不宣告此功能的套件,或 (如果適用) 解決有關您使用此功能的任何問題,並在新提交中要求核准。You then have the option to create a new submission and upload packages which don't declare the capability, or, if applicable, address any issues related to your use of the capability and request approval in a new submission.

注意

如果您的提交使用合作夥伴中心中的開發沙箱 (例如,與 Xbox Live 整合的任何遊戲案例),您必須預先要求核准,而不是在 [提交選項] 頁面提供資訊。If your submission uses a development sandbox in Partner Center (for example, this is the case for any game that integrates with Xbox Live), you must request approval in advance rather than providing info on the Submission options page. 若要這樣做,請瀏覽 Windows 開發人員支援頁面To do so, visit the Windows Developer support page. [開發人員支援主題] 請選取 [儀表板問題],[問題類型] 請選取 [應用程式提交],[子類別] 請選取 [其他]。Select Developer support topic Dashboard issue, Issue Type App submissions, and Subcategory Other. 然後描述您使用此功能的方式,以及您的產品為何需要它。Then describe how you are using the capability and why it is necessary for your product. 如果您未提供所有必要資訊,您的要求將會遭到拒絕。If you do not provide all the information necessary, your request will be denied. 您可能還需要提供更多資訊。You may also be asked to provide more information. 請注意,此程序通常會需要 5 個工作天或更長,所以請事前提交您的要求。Note that this process typically takes 5 business days or longer, so please submit your request well in advance.

不論您是否使用開發沙箱,如果您想要在開始提交之前先確認能獲准使用受限功能,也可以利用這種方式來要求核准 (而不是在提交期間提供這項資訊)。You may also use this method of requesting approval (rather than providing this info during your submission), whether or not you're using a development sandbox, if you prefer to confirm that you are approved to use a restricted capability before you start your submission.

受限功能清單Restricted capability list

下表列出受限制的功能。The following table lists the restricted capabilities. 您可以依照上述的程序,為提交到 Microsoft Store 的應用程式中的這些功能要求核准。You may request approval for these capabilities in apps that you submit to the Store by following the process described above.

重要

除非在非常特定與有限的情況中,否則提交到 Microsoft Store 的應用程式,某些受限制的功能幾乎不會獲得核准。Some of these restricted capabilities are almost never approved for apps submitted to the Store, except in very specific and limited circumstances. 下表說明這些功能。These capabilities are called out in the table below. 如果您想要透過 Microsoft Store 散發您的應用程式,建議您不要在應用程式中宣告這些功能。We recommend not declaring these capabilities in your app if you plan to distribute it through the Store.

功能案例Capability scenario 功能使用方式Capability usage
企業Enterprise Windows 網域認證可以讓使用者使用自己的認證登入遠端資源,如同使用者提供自己的使用者名稱和密碼一樣。Windows domain credentials enable a user to log into remote resources using their credentials, and act as if a user provided their user name and password. enterpriseAuthentication 功能通常是在連線到企業內伺服器的特定業務應用程式中使用。The enterpriseAuthentication capability is typically used in line-of-business apps that connect to servers within an enterprise.

您不需要針對網際網路上的一般通訊使用此功能。You don't need this capability for generic communication across the Internet.

enterpriseAuthentication 功能的目的在於支援常見的特定業務應用程式。The enterpriseAuthentication capability is intended to support common line-of-business apps. 請勿在不需要存取公司資源的 app 中宣告此功能。Don't declare it in apps that don't need to access corporate resources. 檔案選擇器提供健全的 UI 機制,能夠讓使用者開啟網路共用上要供 app 使用的檔案。The file picker provides a robust UI mechanism that enables users to open files on a network share for use with an app. 只有當您應用程式的案例需要以程式設計方式進行存取,而您無法使用 檔案選擇器 來實現時,才需宣告 enterpriseAuthentication 功能。Declare the enterpriseAuthentication capability only when the scenarios for your app require programmatic access, and you cannot realize them by using the file picker.

在您的 app 套件資訊清單中宣告 enterpriseAuthentication 功能時,它必須包含 uap 命名空間,如下所示。The enterpriseAuthentication capability must include the uap namespace when you declare it in your app's package manifest as shown below.

<Capabilities><uap:Capability Name="enterpriseAuthentication"/></Capabilities>

enterpriseDataPolicy 功能可讓應用程式在使用「Windows 資訊保護」原則 (例如:行動裝置管理和行動應用程式管理系統) 管理應用程式時,安全地分開處理企業資料。The enterpriseDataPolicy capability allows apps to handle enterprise data separately and safely when the app is managed with Windows Information Protection policy (For example: Mobile Device Management and Mobile Application Management systems). 如下宣告此受限功能:Declare this restricted capability as shown below.

<Capabilities><rescap:Capability Name="enterpriseDataPolicy"/></Capabilities>

若要使用下列類別的所有成員,必須要有這個功能。This capability is required to use all members of the following classes.
共用的使用者憑證Shared user certificates sharedUserCertificates 功能可讓應用程式在「共用使用者」存放區中新增和存取軟體和硬體型憑證,例如儲存在智慧卡的憑證。The sharedUserCertificates capability enables an app to add and access software and hardware-based certificates in the Shared User store, such as certificates stored on a smart card. 這個功能通常用於需要使用智慧卡進行身分驗證的金融或企業 app。This capability is typically used for financial or enterprise apps that require a smart card for authentication.

在您的 app 套件資訊清單中宣告 sharedUserCertificates 功能時,它必須包含 uap 命名空間,如下所示。The sharedUserCertificates capability must include the uap namespace when you declare it in your app's package manifest as shown below.

<Capabilities><uap:Capability Name="sharedUserCertificates"/></Capabilities>
文件*Documents* documentsLibrary 功能提供以程式設計方式存取使用者的 [文件] 程式庫 (並篩選出封裝資訊清單所宣告的檔案類型關聯)。The documentsLibrary capability provides programmatic access to the user's Documents library, filtered to the file type associations declared in the package manifest. 例如,如果文書處理應用程式宣告了 .doc 檔案類型關聯,它就可以開啟使用者 [文件] 程式庫中的 .doc 檔案。For example, if a word processing app declared a .doc file type association, it can open .doc files in the user's Documents library.

只有在應用程式以程式設計方式存取 Documents 程式庫,而「不需」使用者介入時,才需要 documentsLibrary 功能。The documentsLibrary capability is only needed if your application programmatically accesses the Documents library without user intervention. 如果使用者使用選擇器 API 進行選擇,您的應用程式 需要 documentsLibrary 功能即可存取 Documents 程式庫。Your application does not need the documentsLibrary capability to access the Documents library if the user chooses it with a picker API. 一般而言,應用程式應該使用下列其中一個選擇器 API 來允許使用者選擇其檔案的位置:Generally, apps should allow the user to choose the location of their files, using one of the following picker APIs: 使用這些 API 可讓使用者選擇最適合的位置,例如雲端同步處理的帳戶 (例如 OneDrive)。Using these APIs allows the user to choose a location that works best for them, such as a cloud-synced account (eg, OneDrive). 使用者使用這些 API 挑選檔案或資料夾之後,您的應用程式就可以接著使用 FutureAccessList API 來存取該位置。After the user has picked a file or folder using these APIs, your app can get ongoing access to the location by using the FutureAccessList API. 此 API 可讓您的應用程式在未來存取檔案或資料夾,而不會要求使用者再次加以選擇。This API allows your app to access the files or folders in the future without asking the user to pick them again.

在現有工作流程假設檔案會在 [文件] 程式庫中 (例如,與現有的傳統型應用程式交互操作) 的情況,或您不想讓使用者選擇位置的情況下,您可以為應用程式宣告 documentsLibrary 功能。In cases where existing workflows assume files will be in the Documents library (for example, interop with an existing desktop application) or where you do not want the user to have to choose the location, you can declare the documentsLibrary capability for your application. 如果您的應用程式使用 documentsLibrary 功能,建議您也允許使用者手動挑選位置。If you use the documentsLibrary capability for your application, it is recommended that you also allow the user to pick locations manually.

在您的 app 套件資訊清單中宣告 documentsLibrary 功能時,它必須包含 uap 命名空間,如下所示。The documentsLibrary capability must include the uap namespace when you declare it in your app's package manifest as shown below.

<Capabilities><uap:Capability Name="documentsLibrary"/></Capabilities>
遊戲 DVR 設定Game DVR Settings appCaptureSettings 受限制的功能讓 app 能夠控制「遊戲 DVR」的使用者設定。The appCaptureSettings restricted capability allows apps to control the user settings for the Game DVR.

需要具備這個功能,才能使用 Windows.Media.Capture 命名空間中的某些 API。This capability is required to use some APIs in the Windows.Media.Capture namespace.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
行動電話通訊Cellular cellularDeviceControl 受限制的功能讓 app 能夠控制行動電話通訊裝置。The cellularDeviceControl restricted capability allows apps to have control over the cellular device.

cellularDeviceIdentity 功能讓 app 能夠存取行動電話通訊識別資料。The cellularDeviceIdentity capability allows apps to access cellular identification data.

cellularMessaging 功能讓 app 能夠使用簡訊和 RCS。The cellularMessaging capability allows apps to make use of SMS and RCS.

需要具備這些功能,才能使用 Windows.Devices.Sms 命名空間中的某些 API。These capabilities are required to use some APIs in the Windows.Devices.Sms namespaces.
裝置解除鎖定Device Unlock deviceUnlock 受限制的功能讓 app 能夠解除鎖定裝置,以供開發人員和企業側載案例使用。The deviceUnlock restricted capability allows apps to unlock a device for developer and enterprise sideloading scenarios.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
雙 SIM 卡磚Dual SIM Tiles dualSimTiles 受限制的功能讓應用程式能夠在配備多張 SIM 卡的裝置上建立其他應用程式清單項目。The dualSimTiles restricted capability allows apps to create an additional app list entry on devices that have multiple SIMs.

需要具備這個功能,才能使用 Windows.UI.StartScreen 命名空間中的某些 API。This capability is required to use some APIs in the Windows.UI.StartScreen namespace.
企業共用存放裝置Enterprise Shared Storage enterpriseDeviceLockdown 受限制的功能讓 app 使用裝置鎖定 API,以及存取企業共用存放裝置資料夾。The enterpriseDeviceLockdown restricted capability allows apps to use the device lock down API and access the enterprise shared storage folders.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
系統輸入導入System Input Injection inputInjectionBrokered 受限功能讓應用程式能夠以程式設計方式,將各種不同形式的輸入 (例如,HID、觸控、手寫筆、鍵盤、滑鼠) 導入系統中。The inputInjectionBrokered restricted capability allows apps to inject various forms of input such as HID, touch, pen, keyboard or mouse into the system programmatically. 這個功能通常用於可控制系統的共同作業應用程式。This capability is typically used for collaboration apps that can take control of the system.

在電腦上,從具備此功能的應用程式導入的輸入源,只能透過位於相同應用程式容器的處理程序來接收。For a PC, input injection from an app that has this capability will only be received by processes in the same App Container.

<Capabilities><rescap:Capability Name="inputInjectionBrokered" /></Capabilities>
觀察輸入*Observe Input* inputObservation 受限制的功能讓 app 能夠觀察系統所接收到的各種不同形式的原始輸入 (例如,HID、觸控、手寫筆、鍵盤或滑鼠),而不論其最終目的地為何。The inputObservation restricted capability allows apps to observe various forms of raw input such as HID, touch, pen, keyboard, or mouse being received by the system regardless of its final destination.

這項功能及其相關的 API 僅供選定的 Microsoft 合作夥伴使用。This capability and the APIs related to it are only available for use by select Microsoft partners.
隱藏輸入Suppress Input inputSuppression 受限制的功能讓 app 能夠隱藏系統所接收到的各種不同形式的原始輸入 (例如,HID、觸控、手寫筆、鍵盤或滑鼠)。The inputSuppression restricted capability allows apps to suppress various forms of raw input such as HID, touch, pen, keyboard, or mouse from being received by the system.

這項功能及其相關的 API 僅供選定的 Microsoft 合作夥伴使用。This capability and the APIs related to it are only available for use by select Microsoft partners.
VPN 應用程式VPN App networkingVpnProvider 受限制的功能讓 app 能夠具備 VPN 功能的完整存取權,包括管理連線的能力,以及提供 VPN 外掛程式功能。The networkingVpnProvider restricted capability allows apps to have full access to VPN features, including the ability to manage connections and provide VPN Plugin functionality.

需要具備這個功能,才能使用 Windows.Networking.Vpn 命名空間中的某些 API。This capability is required to use some APIs in the Windows.Networking.Vpn namespace.
其他應用程式管理Other App Management packageManagement 受限制的功能讓 app 能夠直接管理其他 app。The packageManagement restricted capability allows apps to manage other apps directly.

packageQuery 裝置功能讓 app 能夠收集其他 app 的相關資訊。The packageQuery device capability allows apps to gather information about other apps.

需要具備這個功能,才能使用存取 PackageManager 類別中的某些方法和屬性。These capabilities are required to access some methods and properties in the PackageManager class.
畫面投影Screen Projection screenDuplication 受限制的功能讓 app 能將畫面投影到其他裝置。The screenDuplication restricted capability allows apps to project the screen on another device.

需要具備這個功能,才能使用 DirectX 命名空間中的 API。This capability is required to use APIs in the DirectX namespace.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
使用者主體名稱User Principal Name userPrincipalName 受限功能可讓應用程式存取目前使用者的使用者主要名稱 (UPN)。The userPrincipalName restricted capability allows apps to access the user principal name (UPN) of the current user.

需要具備這個功能,才能呼叫 GetUserNameEx 函式。This capability is required to call the GetUserNameEx function.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
電子錢包Wallet walletSystem 受限制的功能讓 app 能完整存取儲存式電子錢包卡。The walletSystem restricted capability allows apps to have full access to the stored wallet cards.

需要具備這個功能,才能使用 Windows.ApplicationModel.Wallet.System 命名空間中的 API。This capability is required to use APIs in the Windows.ApplicationModel.Wallet.System namespace.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
位置歷程記錄Location History locationHistory 受限制的功能讓 app 能夠存取裝置的位置歷程記錄。The locationHistory restricted capability allows apps to access the location history of the device.

需要具備這個功能,才能使用 Windows.Devices.Geolocation 命名空間中的 API。This capability is required to use APIs in the Windows.Devices.Geolocation namespace.
應用程式關閉確認App Close Confirmation confirmAppClose 受限制的功能讓 app 能夠關閉本身和它們自己的視窗,並延遲關閉它們的 app。The confirmAppClose restricted capability allows apps to close themselves, their own windows, and delay the closing of their app.

Windows 10 版本 1703 (組建 10.0.15063) 及更新版本的應用程式可能會要求此功能。Apps may request this capability in Windows 10 version 1703 (build 10.0.15063) and beyond. 在先前的 Windows 10 版本中,此功能為私用,並且導致應用程式安裝失敗而顯示「此應用程式無法授權要求的功能」錯誤訊息。In prior Windows 10 versions the capability is private and will cause app install to fail with error message "The requested capability can not be authorized for this application."
通話記錄*Call History* phoneCallHistory 受限制的功能讓 app 能夠讀取通訊記錄並刪除記錄中的項目。The phoneCallHistory restricted capability allows apps to read the call history and to delete entries in the history.

需要具備這個功能,才能使用 Windows.ApplicationModel.Chat 命名空間中的 API。This capability is required to use APIs in the Windows.ApplicationModel.Chat namespace.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
系統層級的約會存取System Level Appointment Access appointmentsSystem 受限制的功能讓 app 能夠讀取和修改使用者行事曆上的所有約會。The appointmentsSystem restricted capability allows apps to read and modify all appointments on the user's calendar.

需要具備這個功能,才能使用 Windows.ApplicationModel.Appointment 命名空間中的 API。This capability is required to use APIs in the Windows.ApplicationModel.Appointment namespace.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
系統層級的聊天訊息存取*System Level Chat Message Access* chatSystem 受限制的功能讓 app 能夠讀取和寫入所有簡訊和多媒體簡訊訊息。The chatSystem restricted capability allows apps to read and write all SMS and MMS messages.
需要具備這個功能,才能使用 Windows.ApplicationModel.Chat 命名空間中的 API。This capability is required to use APIs in the Windows.ApplicationModel.Chat namespace.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
系統層級的連絡人存取System Level Contact Access contactsSystem 受限制的功能讓 app 能夠讀取已指定為受限制或敏感的連絡人資訊,並修改現有的連絡人資訊。The contactsSystem restricted capability allows apps to read contact information that has been designated as restricted or sensitive and modify existing contact information.

需要具備這個功能,才能使用 Windows.ApplicationModel.Chat 命名空間中的 API。This capability is required to use APIs in the Windows.ApplicationModel.Chat namespace.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
電子郵件存取Email Access email 受限制的功能讓 app 能夠讀取、分級,以及傳送電子郵件給使用者。The email restricted capability allows apps to read, triage, and send user emails.

需要具備這個功能,才能使用 Windows.ApplicationModel.Email 命名空間中的 API。This capability is required to use APIs in the Windows.ApplicationModel.Email namespace.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
系統層級的電子郵件存取System Level Email Access emailSystem 受限制的功能讓 app 能夠讀取、分級,以及傳送受限制或敏感的電子郵件給使用者。The emailSystem restricted capability allows apps to read, triage, and send user restricted or sensitive emails.

需要具備這個功能,才能使用 Windows.ApplicationModel.Email 命名空間中的 API。This capability is required to use APIs in the Windows.ApplicationModel.Email namespace.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
系統層級的通話記錄存取System Level Call History Access phoneCallHistorySystem 受限制的功能讓 app 能夠透過變更現有項目及撰寫新項目來完整修改通話記錄。The phoneCallHistorySystem restricted capability allows apps to fully modify the call history by changing existing entries and writing new ones.

需要具備這個功能,才能使用 Windows.ApplicationModel.Calls 命名空間中的 API。This capability is required to use APIs in the Windows.ApplicationModel.Calls namespace.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
傳送簡訊*Send Text Messages* smsSend 受限制的功能讓 app 能夠傳送簡訊和多媒體簡訊訊息。The smsSend restricted capability allows apps to send SMS and MMS messages.

需要具備這個功能,才能使用 Windows.ApplicationModel.Chat 命名空間中的 API。This capability is required to use APIs in the Windows.ApplicationModel.Chat namespace.
所有使用者資料的系統層級存取System Level Access to All User Data userDataSystem 受限制的功能讓 app 能夠存取使用者資料系統資料存放區。The userDataSystem restricted capability allows apps to access the user data system datastore.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
Store 預覽功能Store Preview Features previewStore 受限制的功能讓 app 能夠擷取並購買 app 內產品的 SKU。The previewStore restricted capability allows apps to retrieve and purchase SKUs of in-app products.

需要具備這個功能,才能使用 Windows.ApplicationModel.Store.Preview 命名空間中的特定 API。This capability is required to use certain APIs in the Windows.ApplicationModel.Store.Preview namespace.
第一次登入設定First-Time Sign-in Settings firstSignInSettings 受限制的功能讓 app 能夠存取使用者首次登入其裝置時所設定的使用者設定。The firstSignInSettings restricted capability allows apps to access user settings that were set when the user first signed in to their device.
Windows Teams 體驗Windows Team Experience teamEditionExperience 受限制的功能讓 app 能夠存取控制 Windows 小組工作階段各個體驗層面的內部 API。The teamEditionExperience restricted capability allows apps to access internal APIs that control many experiential aspects of a Windows Team session. Windows 小組工作階段極有可能會在小組裝置 (如 Microsoft Surface Hub) 上執行。A Windows Team session is likely to be running on a team device such as a Microsoft Surface Hub.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
遠端解除鎖定Remote Unlock remotePassportAuthentication 受限制的功能讓 app 能夠存取可以用來解除遠端電腦鎖定的認證。The remotePassportAuthentication restricted capability allows apps to access credentials that can be used to unlock a remote PC.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
預覽組合Preview Composition previewUiComposition 受限制的功能讓 app 能夠預覽其使用者介面的 Windows.UI.Composition 命名空間,以便他們可以在完成 API 之前提供意見反應。The previewUiComposition restricted capability allows apps to preview the Windows.UI.Composition namespace for their user interface so they can provide feedback on the API before it is completed. 如需詳細資訊,請連絡 wincomposition@microsoft.com。Please contact wincomposition@microsoft.com for more information.
安全性評定鎖定Secure Assessment Lockdown secureAssessment 受限制的功能讓 app 能夠將 Windows 鎖定為單一 app 模式以進行安全性評定。The secureAssessment restricted capability allows apps to lockdown Windows into a single app mode for secure assessments.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
連線管理員佈建Connection Manager Provisioning networkConnectionManagerProvisioning 受限制的功能讓 app 能夠定義可將裝置連線到 WWAN 和 WLAN 介面的原則。The networkConnectionManagerProvisioning restricted capability allows apps to define the policies that connect the device with WWAN and WLAN interfaces. 電信業者會建立使用這個功能的 app,以便管理連線至其行動網路的裝置。Apps that use this capability are created by Mobile Operators to govern the devices that connect to their mobile network.
行動數據方案佈建Data Plan Provisioning networkDataPlanProvisioning 受限制的功能讓 app 能夠收集裝置上行動數據方案的相關資訊,並讀取網路使用量。The networkDataPlanProvisioning restricted capability allows apps to gather information about data plans on the device and read network usage. 電信業者會建立使用這個功能的 app,以便將其客戶的實際數據使用量整合到 OS 數據使用量設定。Apps that use this capability are created by Mobile Operators to integrate their customers' actual data usage into the OS Data usage setting.
軟體授權Software Licensing slapiQueryLicenseValue 受限制的功能讓 app 能夠查詢軟體授權原則。The slapiQueryLicenseValue restricted capability allows apps to query software licensing policies.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
延伸執行Extended Execution extendedBackgroundTaskTime 受限功能可防止背景工作因執行時間限制而遭到取消或終止。The extendedBackgroundTaskTime restricted capability prevents background tasks from being cancelled or terminated due to execution time limits. 但仍會受制於所有其他記憶體和能源使用量的限制。They are still subject to all other memory and energy usage limits. 這項功能可以透過電池使用量或隱私權背景應用程式設定進行限制。This capability can be restricted using the Battery Usage or Privacy Background Apps Settings. 請注意:消費者和系統管理員仍然可以透過群組原則設定控制背景工作。Note that consumers and administrators still have the ability to control background tasks through the Group Policy settings.

extendedExecutionBackgroundAudio 受限制的功能讓 app 能夠在背景執行時也能播放音訊。The extendedExecutionBackgroundAudio restricted capability allows apps to play audio when the app is not in the foreground.

extendedExecutionCritical 受限制的功能讓 app 能夠開始嚴重延伸執行工作階段。The extendedExecutionCritical restricted capability allows apps to begin a critical extended execution session.

extendedExecutionUnconstrained 受限制的功能讓 app 能夠開始不受限制的延伸執行工作階段。The extendedExecutionUnconstrained restricted capability allows apps to begin an unconstrained extended execution session.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.

如需有關在應用程式暫止時使用延伸執行延期的詳細資訊,請參閱透過延長執行延後應用程式暫停See Postpone app suspension with extended execution for more information about using extended execution to postpone when your app is suspended.
行動裝置管理Mobile Device Management deviceManagementDmAccount 受限制的功能讓 app 能夠佈建和設定 [電信業者開放行動裝置聯盟 - 裝置管理 (MO OMA-DM)] 帳戶。The deviceManagementDmAccount restricted capability allows apps to provision and configure Mobile Operator Open Mobile Alliance - Device Management (MO OMA-DM) accounts.

deviceManagementFoundation 受限制的功能讓 app 能夠基本存取裝置上的行動裝置管理 (MDM) 設定服務提供者 (CSP) 基礎結構。The deviceManagementFoundation restricted capability allows apps to have basic access to the Mobile Device Management (MDM) configuration service provider (CSP) infrastructure on the device. 請注意,需有其他功能才能存取特定 CSP。Note that other capabilities are needed to access specific CSPs.

deviceManagementWapSecurityPolicies 受限制的功能讓 app 能夠設定無線應用通訊協定 (WAP) 服務,例如 MMs、服務指示/服務載入 (SI/SL) 及開放行動裝置聯盟 - 用戶端佈建 (OMA-CP)。The deviceManagementWapSecurityPolicies restricted capability allows apps to configure Wireless Application Protocol (WAP)-based services such as MMs, Service Indication/Service Loading (SI/SL), and Open Mobile Alliance - Client Provisioning (OMA-CP).

deviceManagementEmailAccount 受限制的功能讓 app 能夠由電信業者建立,以便在他們佈建給使用者的裝置上新增和管理電子郵件帳戶。The deviceManagementEmailAccount restricted capability allows apps created by Mobile Operators to add and manage an email account on devices they provision to users.
套件原則控制項Package Policy Control packagePolicySystem 受限制的功能讓 app 能夠掌控裝置上所安裝之 app 的相關系統原則。The packagePolicySystem restricted capability allows apps to have control of system policies related to apps that are installed on the device.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
遊戲清單Games List gameList 受限制的功能讓 app 能夠取得一份系統上已安裝的知名遊戲清單。The gameList restricted capability allows apps to get a list of known games installed on the system.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
Xbox 配件Xbox Accessory xboxAccessoryManagement 受限制的功能讓 app 能夠直接管理符合 Xbox 硬體規格的 Xbox 裝置。The xboxAccessoryManagement restricted capability allows apps to directly manage Xbox devices that conform to the Xbox hardware specification.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
附屬應用程式的語音辨識Speech Recognition for Accessories cortanaSpeechAccessory 受限制的功能讓 app 能夠叫用並傳遞命令到 Cortana。The cortanaSpeechAccessory restricted capability allows apps to invoke and pass commands to Cortana.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
配件管理Accessory Management accessoryManager 受限制的功能讓 app 能夠註冊為配件專屬 App,並選擇加入特定 app 通知,以便將它們轉送到配件並向使用者顯示。The accessoryManager restricted capability allows apps to register as an accessory app and opt-in to specific app notifications so that they may be forwarded to accessories and display to the user.
驅動程式存取Driver access interopServices 受限制的功能讓 app 能夠直接與驅動程式互動。The interopServices restricted capability allows apps to interact directly with drivers.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
前景觀察Foreground observation inputForegroundObservation 受限制的功能讓前景的 app 能夠攔截鍵盤輸入,並繞過所有非 app 鍵盤輸入的處理。The inputForegroundObservation restricted capability allows apps in the foreground to intercept keyboard input and byasses all non-app keyboard input processing. 此功能無法攔截 SAS 組合。SAS combinations cannot be intercepted by this capability. 需要具備這個功能,才能存取 KeyboardDeliveryInterceptor 類別的成員。This capability is required to access members of the KeyboardDeliveryInterceptor class.
OEM 和 MO 合作夥伴應用程式OEM and MO Partner apps oemDeployment 受限制的功能讓 Microsoft 合作夥伴建立的 app 可以在裝置上安裝新的 app 和查詢目前安裝的 app。The oemDeployment restricted capability allows apps that are created by Microsoft partners to install new apps and query currently installed apps on the device.

oemPublicDirectory 受限制的功能讓 Microsoft 合作夥伴建立的 app 可以存取共用 app 資料夾。The oemPublicDirectory restricted capability allows apps that are created by Microsoft partners to have access to the shared app folder. 我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
應用程式授權App Licensing appLicensing 受限制的功能可允許 app 在不需要授權的情況下執行。The appLicensing restricted capability allows apps to run without the need of a license. 如果您在資訊清單中宣告此功能,您就無法將 app 提交至市集。You cannot submit your app to the store if you declare this capability in your manifest.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
位置系統Location System locationSystem 受限制的功能可允許 app 執行特定需要特殊權限的位置設定,例如設定裝置的預設位置。The locationSystem restricted capability allows apps to perform certain privileged location configurations like setting the default location for the device.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
使用者資料帳戶提供者User Data Accounts Provider userDataAccountsProvider 受限制的功能讓 app 能夠完全管理電子郵件、行事曆和連絡人帳戶。The userDataAccountsProvider restricted capability allows apps to fully manage the mail, calendar, and contact accounts.
手寫筆工作區Pen Workspace previewPenWorkspace 功能讓 app 能夠存取 Windows.ApplicationModel.Preview.Notes 命名空間,此命名空間要裝載於手寫筆工作區內部,以做為記住動作處理常式。The previewPenWorkspace capability allows an app to access the Windows.ApplicationModel.Preview.Notes namespace to be hosted inside the pen workspace as the remember action handler.
第二個驗證因素Secondary Authentication Factor secondaryAuthenticationFactor 功能讓 app 能夠透過傳送儲存於鄰近隨附驗證裝置上的密碼來解除鎖定電腦。The secondaryAuthenticationFactor capability allows an app to unlock a PC by passing the secrets store on a nearby companion authentication device. 例如,隨附的健身手環可以用來解除鎖定電腦。For example, a companion fitness band can be used to unlock the PC. 需要具備這個功能,才能存取 Windows.Security.Authentication.Identity.Provider 命名空間中的 API。This capability is required to access APIs in the Windows.Security.Authentication.Identity.Provider namespace.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
Store 授權管理Store License Management storeLicenseManagement 功能讓 Microsoft 合作夥伴中樞應用程式能夠管理裝置上的市集授權。The storeLicenseManagement capability allows Microsoft partner hub-apps to manage store licenses on the device. 需要具備這個功能,才能存取 Windows.ApplicationModel.Store.LicenseManagement 命名空間中的 API。This capability is required to access APIs in the Windows.ApplicationModel.Store.LicenseManagement namespace.
使用者系統識別碼User System ID userSystemId 功能讓 app 能夠取得使用者特定的系統識別碼。The userSystemId capability allows apps to get a system identifier specific to the user. 這個識別碼可唯一識別特定系統上目前的使用者,也可以用來使應用程式間的資訊互相關聯。This identifier uniquely identifies the current user on a specific system and can be used to correlate information across apps. 需要具備這個功能,才能存取 Windows.System.Profile.SystemIdentification 類別中的 GetUserSpecificSystemId API。This capability is required to access the GetUserSpecificSystemId API in the Windows.System.Profile.SystemIdentification class.
目標式內容Targeted Content targetedContent 功能提供應用程式擷取及使用 Windows.Services.TargetedContent 命名空間提供之目標訂閱內容的能力。The targetedContent capability provides an application the ability to retrieve and use targeted subscription content provided by the Windows.Services.TargetedContent namespace.

必須具備這項功能,才能使用 Windows.System.Profile.SystemIdentification 命名空間中的某些 API。This capability is required to use some APIs in the Windows.System.Profile.SystemIdentification namespace.
使用者介面自動化UI Automation uiAutomation 功能可讓 UI 自動化用戶端 (例如朗讀程式) 連接至 UI 自動化伺服器或提供者。The uiAutomation capability allows a UI automation client, such as Narrator, to connect to a UI Automation server or provider.

必須具備這項功能,才能使用 Windows.Xbox.Media.Capture.Broadcaster 命名空間中的某些 API。This capability is required to use some APIs in the Windows.Xbox.Media.Capture.Broadcaster namespace.
遊戲列服務Game Bar Services gameBarServices 僅限於第一方 Microsoft Store 可更新收件匣的 UWA。The gameBarServices is restricted to 1st party store updatable inbox UWAs.

必須具備這項功能,才能使用 Windows.Media.Capture.GameBarsSrvices 類別。This capability is required to use the Windows.Media.Capture.GameBarsSrvices class.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
應用程式擷取服務App Capture Services appCaptureServices 功能僅限於與 Microsoft 具有契約關係之對象。The appCaptureServices capacity is limited to parties with which Microsoft has contractual relationships. 這些關係會根據由 Xbox 服務及 bizdev 支援推動的合作夥伴協議進行授與。These relationships are granted based on partner agreements, which are being driven with the help of Xbox Services and bizdev.

必須具備這項功能,才能使用 Windows.Media.Capture.AppCaptureServices 類別。This capability is required to use the Windows.Media.Capture.AppCaptureServices class.
應用程式廣播服務App Broadcast Services appBroadcastServices 功能僅限於與 Microsoft 具有契約關係之對象。The appBroadcastServices capability is limited to parties with which Microsoft has contractual relationships. 這些關係會根據由 Xbox 服務支援推動的合作夥伴協議進行授與。These relationships are granted based on partner agreements, which are being driven with the help of Xbox Services.

必須具備這項功能,才能使用 Windows.Media.capture.AppBroadcastServices 類別。This capability is required to use the Windows.Media.capture.AppBroadcastServices class.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
音訊裝置設定Audio Device Configuration audioDeviceConfiguration 功能可以讓應用程式查詢、設定、啟用、停用音訊驅動程式公開的音訊效果。The audioDeviceConfiguration This capability allows an application to query, configure, enable, and disable audio effects exposed by the audio driver.

必須具備這項功能,才能使用 Windows.Media.Devices.AudioDeviceModulesManager 類別。This capability is required to use the Windows.Media.Devices.AudioDeviceModulesManager class.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved. 這是因為 AudioDeviceModulesManager 可讓應用程式存取特定系統上所有的音訊效果。This is because AudioDeviceModulesManager allows an application to access to all audio effects on a given system. 而音訊效果有可能會用於造成裝置上音訊效能的負面影響。Potentially, the audio effects can be set to negatively impact audio performance on the device.
背景媒體錄影Background Media Recording backgroundMediaRecording 功能會變更媒體特定 API (例如 MediaCaptureAudioGraph 類別) 的行為,以便在您的應用程式位於背景時啟用媒體錄影。The backgroundMediaRecording capability changes the behavior of the media-specific APIs like the MediaCapture and AudioGraph classes to enable media recording while your app is in the background.
預覽 Ink 工作區Preview Ink Workspace previewInkWorkspace 功能可讓應用程式存取裝載在 Ink 工作區的預覽 Ink 命名空間。The previewInkWorkspace capability allows an app to access the Preview Ink namespace hosted inside the ink workspace. 一般而言,OEM 會使用這項功能來取代裝置上的白板應用程式。Generally speaking, this is used by an OEM to replace the whiteboard application on a device.

必須具備這項功能,才能使用 Windows.ApplicationModel.Preview.InkWorkspace 命名空間中的 API。This capability is required to the APIs in the Windows.ApplicationModel.Preview.InkWorkspace namespace.
開始畫面管理Start Screen Management startScreenManagement 功能可讓應用程式直接將磚釘選至開始畫面。The startScreenManagement capability allows apps to silently pin Tiles to the Start screen. 應用程式也可以在背景進行釘選。Apps can also pin from the background. 不具備 startScreenManagement 功能並不會封鎖任何 API。然而,使用 startScreenManagement 表示命令介面不會在任何應用程式使用釘選 API 時顯示任何 UI。Not having the startScreenManagement capability does not block any APIs; rather, using startScreenManagement means that the Shell will not display any UI when an app uses the Pin API.
Cortana 權限Cortana Permissions cortanaPermissions 功能可讓應用程式列舉使用者授與裝置上 Cortana 的權限。The cortanaPermissions capability allows an app to enumerate the permissions that the user has granted Cortana on the device. 此功能同時也允許應用程式授與或撤銷裝置上 Cortana 的權限。The capability also allows an app to grant and revoke Cortana permissions on the device. 請注意,使用 cortanaPermissions 需要裝置在授與權限前顯示法律聲明文字。Note that using cortanaPermissions requires that the device display legal text before granting permissions. 因此,應用程式應負起責任,告知使用者修改權限可能造成的法律後果。As such, it is the responsiblity of the app to inform the user of the legal consequences of modifying permissions.


必須具備這項功能,才能取得 HKCU\SOFTWARE\Microsoft\Windows\CurrentVersion\Search 登錄設定的讀取權限。This capability is required to gain read access to the HKCU\SOFTWARE\Microsoft\Windows\CurrentVersion\Search registry settings.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
所有應用程式模組All App Mods allAppMods 功能可讓應用程式存取所有應用程式的 AppMods 資料夾。The allAppMods capability allows an app to access the AppMods folder for all apps. 模組管理公用程式使用 allAppMods 在使用該模組的遊戲或應用程式之外管理模組。Mod Management utilities use allAppMods to manage mods outside of the game or app that consume them.
展開的資源Expanded Resources expandedResources 功能可讓應用程式存取遊戲模式資源。The expandedResources capability allows an app access to the Game Mode resources. 在 Xbox 以及符合足夠標準的電腦上,遊戲模式資源代表可供應用程式獨佔使用的保留 CPU 核心子集。On Xbox, and on PCs that meet a sufficient bar, Game Mode resources represent a subset of the available CPU cores that are reserved for the app's exclusive use. 在 Xbox 上,應用程式也有至少 4 GB 記憶體分割的獨佔使用權。On Xbox, the app also has exclusive use of a memory partition of at least 4GB.

必須具備這項功能,才能取得如上方所定義之 CPU 和記憶體資源的獨佔使用權。This capability is required to gain exclusive use of CPU and memory resources as defined above.
受保護的應用程式Protected App protectedApp 功能授與應用程式能夠被 Microsoft Store 載入受保護程序的能力。The protectedApp capability grants an app the ability to be loaded into a procteded process by the store. 當應用程式內嵌至 Microsoft Store 時,Microsoft Store 會在執行檔中加入一個 blob。When the app is ingested into the store, the store adds a blob to the executable. Microsoft Store 也會使用 Microsoft 金鑰在執行檔上頁面簽署。The store also page signs the executable with a Microsoft key. 由於 blob 需要 Microsoft 的簽章,程序載入器會檢查此 blob,而非這個功能強迫受保護的程序。The process loader checks for this blob rather than the capability to enforce protected process, as the blob needs a Microsoft signature.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
遊戲監視器Game Monitor gameMonitor 功能會讓系統使用主動式監視來偵測應用程式的遊戲作弊行為。The gameMonitor capability causes the system to use active monitoring to detect game cheats by the app.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
應用程式診斷App Diagnostics appDiagnostics 功能可讓應用程式取得任何其他正在執行中之 UWP 應用程式的診斷資訊 (例如:套件資訊、記憶體使用量、帳戶名稱)。The appDiagnostics capability allows an app to get diagnostic information, (such as package information, memory usage, and account name) for any other running UWP app. 傳回的資訊包含了正在執行該應用程式的網域/機器帳戶名稱。若呼叫的應用程式是以系統管理員權限啟動的,則該應用程式還可以擷取機器上所有帳戶正在執行的所有應用程式清單。The information returned includes the domain/machine account name under which the app is running; if the calling app is launched with Administrator rights then the app can retrieve a list of all running apps for all accounts on the machine.

必須具備這項功能,才能使用 Windows.System.AppDiagnosticInfoWindows.System.AppDiagnosticInfo.RequestAppDiagnosticInfoAsyncWindows.ApplicationModel.AppInfo 類別。This capability is required to use the Windows.System.AppDiagnosticInfo, Windows.System.AppDiagnosticInfo.RequestAppDiagnosticInfoAsync, and Windows.ApplicationModel.AppInfo classes.
裝置入口網站提供者Device Portal Providers devicePortalProvider 功能可讓應用程式呼叫 Windows.System.Diagnostics.DevicePortal API,並在開發人員模式下做為診斷工具的 網頁伺服器The devicePortalProvider capability allows apps to call the Windows.System.Diagnostics.DevicePortal APIs, and serve as a webserver for diagnostic tooling while in Developer Mode.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
企業雲端單一登入Enterprise Cloud Single Sign On enterpriseCloudSSO 功能可讓應用程式搭配 Web 檢視託管控制項內部的 Azure Active Director (AAD) 資源使用單一登入。The enterpriseCloudSSO capability allows apps to use single sign on with Azure Active Director (AAD) resources inside a hosted web view control.
自動接受 VoIP 通話Automatically accept VoIP calls backgroundVoIP 功能可讓您自動接收和接聽 VoIP 來電,而不需要使用者明確接受通話。The backgroundVoIP capability allows you to automatically receive and accept incoming VoIP calls without requiring the user to accept the call explicitly. 使用這項功能的應用程式獲得攝影機及麥克風的完整控制權,並且可以在背景使用這些資源。Apps utilizing this capability are granted full control of camera and microphone and can use these resources in the background.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend declaring this capability in apps submitted to the Microsoft Store. 大部分的開發人員都不會獲得核准使用這項功能。For most developers, use of this capability won't be approved.
保留 VoIP 通話的資源Reserve resources for VoIP calls oneProcessVoIP 功能可讓您在單一進程應用程式中,保留 VoIP 通話所需的 CPU 和記憶體資源。The oneProcessVoIP capability allows you to reserve the CPU and memory resources necessary for a VoIP call in a single-process application.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend declaring this capability in apps submitted to the Microsoft Store. 大部分的開發人員都不會獲得核准使用這項功能。For most developers, use of this capability won't be approved.
開發模式網路Development Mode Network 呼叫 C++/CX UWP 應用程式或 C++ Windows 執行階段元件中的 OpenFile Win32 API 時,developmentModeNetwork 功能可讓應用程式使用已登入使用者的認證存取網路路徑。The developmentModeNetwork capability allows apps to access network paths using the credentials from the signed-in user when calling the OpenFile Win32 API in a C++/CX UWP app or C++ Windows Runtime component.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
廣泛的檔案系統存取Broad Filesystem Access broadFileSystemAccess 功能可讓應用程式在沒有任何其他檔案選擇器樣式提示的情況下,於執行階段期間取得和目前正在執行應用程式的使用者同樣的檔案系統存取權。The broadFileSystemAccess capability allows apps to get the same access to the file system as the user who is currently running the app without any additional file-picker style prompts during runtime. 請務必注意,存取使用者已使用 FilePicker 或 FolderPicker 選擇的檔案時,不需要這項功能。It is important to note that this capability is not required to access files that the user has already chosen using the FilePicker or FolderPicker.

這項功能適用於 Windows.Storage API。This capability works for the Windows.Storage APIs. 由於使用者隨時都可以在 [設定] 中授與或拒絕權限,您應該確定應用程式針對那些變更具備復原性。Because users can grant or deny the permission any time in Settings, you should ensure that your app is resilient to those changes. 在 2018 年 4 月更新中,該權限的預設值為 [開啟]。In the April 2018 update, the default for the permission is On. 在 2018 年 10 月更新中,預設值為 [關閉]。In the October 2018 update, the default is Off. 同樣重要的是,請勿宣告任何使用這項功能的特殊資料夾功能,例如 [文件]、[圖片] 或 [影片]。It is also important that you do not declare any special folder capabilities such as Documents, Pictures, or Videos with this capability. 您可以藉由將 broadFileSystemAccess 新增至資訊清單,在您的應用程式中啟用這項功能。You can enable this capability in your app by adding broadFileSystemAccess to your manifest. 如需範例,請參閱檔案存取權限一文。For an example, see the File access permissions article.

注意: Xbox 不支援這項功能。Note: This capability is not supported on Xbox.
系統韌體和 BIOSSystem Firmware and BIOS smbios 功能讓應用程式能夠存取 BIOS 資料和系統韌體資料。The smbios capability allows apps to access bios data and system firmware data.
完全信任權限層級Full Trust Permission Level runFullTrust 受限功能可讓應用程式在使用者電腦上以完全信任的權限層級執行。The runFullTrust restricted capability allows apps to run at the full trust permission level on the user's machine. 必須具備這項功能,才能使用 FullTrustProcessLauncher API。This capability is required to use the FullTrustProcessLauncher API.

任何以 appx 或 msix 套件形式提供的傳統型應用程式 (如傳統型橋接器) 都需要這項功能,而且當使用 Desktop App Converter (DAC) 或 Visual Studio 封裝這些應用程式時,它會自動顯示在您的資訊清單中。This capability is also required for any desktop application that is delivered as an appx or msix package (as with the Desktop Bridge), and it will automatically appear in your manifest when packaging these apps using the Desktop App Converter (DAC) or Visual Studio.
提升權限Elevation allowElevation 受限功能可讓 Microsoft 合作夥伴和企業所建立的應用程式,保留在啟動時或在應用程式存留期期間需要自動提升權限的現有傳統型功能。The allowElevation restricted capability allows apps that are created by Microsoft partners and enterprises to preserve existing desktop functionality that requires auto-elevation on launch or during an app's lifetime.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved. 只有在企業透過商務用 Microsoft Store 將營運應用程式部署到其私人存放區的情況下,才會核准此功能。It will only be approved for line-of-business apps deployed by enterprises to their private store via the Microsoft Store for Business.
Windows Teams 裝置認證Windows Team Device Credentials teamEditionDeviceCredential 受限功能可讓應用程式在執行 Windows 10 1703 版或更新版本的 Surface Hub 裝置上,存取要求裝置帳號認證的 API。The teamEditionDeviceCredential restricted capability allows apps to access APIs that request device account credentials on a Surface Hub device running Windows 10, version 1703 or later.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
Windows Teams 應用程式檢視Windows Team Application View teamEditionView 受限功能可讓應用程式存取 API,以便在執行 Windows 10 版本 1703 或更新版本的 Surface Hub 裝置上裝載應用程式檢視。The teamEditionView restricted capability allows apps to access APIs for hosting an application view on a Surface Hub device running Windows 10, version 1703 or later.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
相機處理延伸模組Camera Processing Extension cameraProcessingExtension 受限功能可讓應用程式處理從相機擷取的影像,而不需要直接控制相機。The cameraProcessingExtension restricted capability allows apps to process images captured from the camera without direct camera control.

需要具備這個功能,才能呼叫 Windows.Devices.PointOfService.Provider 命名空間中的 API。This capability is required to call APIs in the Windows.Devices.PointOfService.Provider namespace.

任何人都可能要求存取這個功能以進行市集提交。Anyone may request access to this capability for store submission.
資料使用方式管理Data usage Management networkDataUsageManagement 受限功能可讓應用程式收集網路資料使用資訊。The networkDataUsageManagement restricted capability allows apps to gather network data usage information.

需要有這項功能,才能呼叫 GetAttributedNetworkUsageAsyncThis capability is required to call GetAttributedNetworkUsageAsync.

任何人都可能要求存取這個功能以進行市集提交。Anyone may request access to this capability for store submission.
管理電話線連線能力Manage phone line connectivity phoneLineTransportManagement 功能可讓應用程式管理負責電話線連線的系統裝置。The phoneLineTransportManagement capability allows apps to manage system devices responsible for phone line connectivity.

需要具備這個功能,才能使用 Windows.ApplicationModel.Calls 命名空間中的 PhoneLineTransportDevice API。This capability is required to use PhoneLineTransportDevice APIs in the Windows.ApplicationModel.Calls namespace.
未虛擬化的資源Unvirtualized Resources unvirtualizedResources 受限功能可讓您的應用程式在其封裝資訊清單中宣告 RegistryWriteVirtualizationFileSystemWriteVirtualization 元素,以停用登錄和檔案系統的虛擬化。The unvirtualizedResources restricted capability enables your application to declare the RegistryWriteVirtualization and FileSystemWriteVirtualization elements in its package manifest to disable virtualization for the registry and file system. 這些宣告會防止系統將任何對 HKEY_CURRENT_USER 或對使用者 AppData 資料夾的寫入分別虛擬化。These declarations prevent the system from virtualizing any writes to HKEY_CURRENT_USER or to the user's AppData folder, respectively. 當您的應用程式需要其他應用程式讀取或寫入與您的應用程式相同的登錄或檔案系統項目時,這會很有用。This is useful in scenarios where your application expects other applications to read or write the same registry or file system entries as your application.

這項功能是針對由 Microsoft 和我們的合作夥伴發佈的幾種特定傳統型電腦遊戲所設計。This capability is designed for certain types of desktop PC games that are published by Microsoft and our partners. 其並不適合用於其他案例,因為可能會危害系統完全解除安裝的能力。It is not intended to be used for other scenarios, because it could compromise the system's ability to uninstall cleanly.
可修改的應用程式Modifiable App modifiableApp 受限功能可讓您的應用程式在其封裝資訊清單中宣告 windows.mutablePackageDirectories 延伸模組。The modifiableApp restricted capability enables your application to declare the windows.mutablePackageDirectories extension in its package manifest. 這使得您可以為您的應用程式預期有修改後檔案或新增檔案的資料夾提供名稱。This enables you to provide a name for the folder where your application expects modified or added files to be located. OS 會建立此資料夾,並讓您的應用程式使用此資料夾中的檔案,而不是使用 (或額外再使用) 應用程式原本安裝的檔案。The OS will create this folder and enable your application to use the files in this folder instead of (or in addition to) the files originally installed by the application.

這項功能是針對由 Microsoft 和我們的合作夥伴發佈的幾種特定傳統型電腦遊戲所設計。This capability is designed for certain types of desktop PC games that are published by Microsoft and our partners. 因為此功能允許未簽署的程式碼執行,故不會核准其用在其他案例。It will not be granted for other scenarios, because it can allow unsigned code to execute.
套件寫入重新導向相容性填充碼Package Write Redirection Compatibility Shim packageWriteRedirectionCompatibilityShim 受限功能會將您的應用程式設定為在每個使用者的位置建立所有新檔案。The packageWriteRedirectionCompatibilityShim restricted capability configures your application to create all new files in a per-user location. 系統會將為了寫入而開啟的任何預先存在檔案都先複製到每個使用者的位置,然後修改這些位置中的檔案。Any preexisting files opened for writes are first copied into a per-user location and modifications happen to the file in that location. 這項功能適用於可在其安裝資料夾中建立或修改檔案的應用程式。This capability is useful for applications that create or modify files in their installation folder.

這項功能是針對由 Microsoft 和我們的合作夥伴發佈的幾種特定傳統型電腦遊戲所設計。This capability is designed for certain types of desktop PC games that are published by Microsoft and our partners. 不過,在某些情況下,它也可能適用於其他應用程式。However, it might also be applicable to other apps in some cases.
自訂安裝動作Custom Install Actions customInstallActions 受限功能可讓您的應用程式在其封裝資訊清單中宣告 windows.customInstall 延伸模組,讓它可以指定一或多個與您的應用程式一起執行的額外安裝程式檔案 (.exe 或 .msi)。The customInstallActions restricted capability enables your application to declare the windows.customInstall extension in its package manifest so that it can specify one or more additional installer files (.exe or .msi) that are executed with your application. 這可讓您為任何標準部署案例指定自訂動作:安裝、更新、修復或解除安裝。This allows you to specify custom actions for any of the standard deployment scenarios: install, update, repair, or uninstall. 例如,這適用於搭售協力廠商可轉散發元件的應用程式。For example, this is useful for applications that bundle a 3rd party redistributable component.

這項功能是針對由 Microsoft 和我們的合作夥伴發佈的幾種特定傳統型電腦遊戲所設計。This capability is designed for certain types of desktop PC games that are published by Microsoft and our partners. 不會核准其用在其他案例。It will not be granted for other scenarios.
封裝的服務Packaged Services packagedServices 受限功能可讓 Microsoft 合作夥伴和企業所建立的應用程式在其封裝資訊清單中宣告 windows.service 延伸模組,使其可以與應用程式一起安裝一或多個服務。The packagedServices restricted capability allows applications that are created by Microsoft partners and enterprises to declare the windows.service extension in its package manifest so that it can install one or more services along with the app. 這些服務可以設定為在本機服務、網路服務或本機系統帳戶下執行。These services can be configured to run under the Local Service, Network Service or Local System accounts. 本機服務和網路服務服務只需要 packagedServices 功能。Local Service and Network Service services only require the packagedServices capability. 本機系統服務需要 packagedServiceslocalSystemServices 功能。Local System services require both the packagedServices and localSystemServices capabilities.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
本機系統服務Local System Services localSystemServices 受限功能可讓 Microsoft 合作夥伴和企業所建立的應用程式與應用程式一起安裝一或多個本機系統服務 (也就是,您的應用程式可以將服務的 StartAccount 宣告為 LocalSystem)。The localSystemServices restricted capability allows applications that are created by Microsoft partners and enterprises to install one or more Local System services along with the app (that is, your application can declare the StartAccount for the services to be LocalSystem). 此案例也需要 packagesServices 功能。This scenario also requires the packagesServices capability.

我們不建議您在提交至 Microsoft Store 的應用程式中宣告這項功能。We don't recommend that you declare this capability in applications that you submit to the Microsoft Store. 在大部分情況下,不會核准此功能的使用。In most cases, the use of this capability won't be approved.
背景空間感知Background Spatial Perception backgroundSpatialPerception 受限功能可讓應用程式在背景執行時仍能存取使用者的頭、手、動作控制器和其他追蹤物件的移動。The backgroundSpatialPerception restricted capability allows an application to access the movement of the user's head, hands, motion controllers, and other tracked objects while the app is running in the background.

自訂功能Custom capabilities

前面的受限功能一節描述的功能核准程序,也是您用來要求核准使用自訂功能的程序。The restricted capabilities section above describes the same capability approval process that you can use to request approval to use a custom capability. embedded SIM API 是需要自訂功能的 API 範例。The embedded SIM APIs are examples of APIs that require a custom capability. 如果您只想要以開發人員模式在本機執行應用程式,則不需要自訂功能。If you only want to run your application locally in developer mode, then you don't need the custom capability. 但是若要將您的應用程式發佈至 Microsoft Store 或在開發人員模式之外執行,您就需要自訂功能。But you need it to publish your app to the Microsoft Store, or to run it outside of developer mode.

如果您有 Windows 技術支援專案經理 (TAM),則可以與 TAM 合作要求存取權。If you have a Windows Technical Account Manager (TAM), then you can work with your TAM to request access. 您可以在聯絡 Microsoft TAM 找到更多詳細資料。You can find more details at Contact your Microsoft TAM.

若要宣告自訂功能,請修改您的應用程式封裝資訊清單來源檔案 (Package.appxmanifest)。To declare a custom capability, modify your app package manifest source file (Package.appxmanifest). 新增 xmlns:uap4 XML 命名空間宣告,並在宣告自訂功能時使用 uap4 前置詞。Add the xmlns:uap4 XML namespace declaration, and use the uap4 prefix when you declare your custom capability. 以下是範例。Here's an example.

<?xml version="1.0" encoding="utf-8"?>
<Package
    ...
    xmlns:uap4="http://schemas.microsoft.com/appx/manifest/uap/windows10/4">
...
<Capabilities>
    <uap4:CustomCapability Name="CompanyName.customCapabilityName_PublisherID"/>
</Capabilities>
</Package>

注意

在封裝資訊清單中的 Capabilities 節點底下,所有的 CustomCapability 元素都必須放在任何 Capability 元素之前、任何 DeviceCapability 元素之前。All CustomCapability elements must come after any Capability elements and before any DeviceCapability elements under the Capabilities node in the package manifest.