Android 角色

角色是系統中與特定權限和特權相關聯的專屬名稱。應用程式可透過 Android API 要求保留特定角色，具體方法為叫用 RoleManager 類別中的方法。

以下列出可用的角色及其對應需求：

角色 需求條件
ASSISTANT 至少符合下列其中一項條件：
  • 應用程式會在使用者要求協助功能時，根據使用者上下文資訊 (例如目前前景應用程式的套件名稱及其上下文資訊)，執行協助功能動作。
  • 應用程式提供的隨時語音互動服務受到 android.permission.BIND_VOICE_INTERACTION 權限的限制，可執行語音辨識並代管主動語音互動工作階段。此外，應用程式還有明確的標記，指出服務能夠處理輔助動作。
BROWSER 以下所有項目：
  • 應用程式含有活動，可透過隱含意圖要求叫用，並顯示與 http:// 位址相對應的網頁。
  • 應用程式需要處理連結之間的導覽。也就是說，如果使用者正在查看網頁，並點選文字中的 http:// 位址，應用程式就必須能夠顯示與所選連結相對應的內容，而不需要使用者額外介入。
  • 應用程式必須能夠在使用者核准要求時，將裝置目前的地理位置資訊提供給網頁。
DIALER 下列所有權限：
  • 應用程式含有活動，可透過隱含意圖要求叫用，在裝置通話期間提供通話中的使用者介面。
  • 應用程式可以處理來電意圖，向使用者顯示與通話相關的資訊 (例如來電者的電話號碼)，並讓使用者接聽或拒接來電。
  • 應用程式可讓使用者透過裝置發起通話，並查看通話記錄。
SMS 以下所有項目：
  • 應用程式符合所有簡訊應用程式的相關規定。
  • 應用程式含有可透過隱含意圖要求叫用的活動，可將訊息傳送至電話號碼。
  • 應用程式具有受 android.permission.SEND_RESPOND_VIA_MESSAGE 權限保護，且由隱含意圖叫用的服務，可在使用者選擇在來電期間選擇透過訊息回應時，傳送來自「電話」應用程式的訊息。應用程式可透過自己的訊息系統傳送訊息。
  • 應用程式有兩個廣播接收器，一個受 android.permission.BROADCAST_SMS 權限控管，另一個則受 android.permission.BROADCAST_WAP_PUSH 權限控管，分別可監聽傳送至裝置的文字簡訊和多媒體訊息。應用程式接著負責將訊息寫入 SMS 供應器，並通知使用者。
EMERGENCY 以下所有項目：
  • 應用程式是系統應用程式。
  • 應用程式有一個活動，可顯示使用者的緊急資訊。任何人都可以透過緊急撥號器活動中的緊急按鈕，前往這個畫面。
HOME 應用程式有一個活動，可在使用者按下主畫面按鈕時啟動主畫面。主畫面應顯示應用程式圖示、小工具，並支援以按鈕或手勢 (例如向上滑動即可查看所有應用程式) 進行導覽。
CALL_REDIRECTION 應用程式具有由 android.permission.BIND_CALL_REDIRECTION_SERVICE 權限控管的服務，電信架構可繫結至該服務。服務接收來自電信架構的撥出電話號碼，並執行下列任一動作：
  • 允許通話依原樣進行。
  • 變更撥出號碼，以便透過 Proxy 號碼轉接。
  • 取消通話。
CALL_SCREENING 應用程式具有受 android.permission.BIND_SCREENING_SERVICE 權限管制的服務，會執行兩項功能：
  • 來電封鎖和過濾：服務可以選擇要將哪些來電傳送至手機上的撥號應用程式 (並可能會響鈴，視 DND 或音量而定)，以及要將哪些來電傳送至語音信箱。
  • 呼叫識別：服務可透過使用者介面識別並顯示通話相關資訊，
SYSTEM_GALLERY 以下所有項目：
  • 應用程式是系統應用程式。
  • 只有原始設備製造商 (OEM) 可以將這個角色授予應用程式。
  • 應用程式提供 UI，讓使用者儲存、整理及顯示影片和圖片。
SYSTEM_AUTOMOTIVE_CLUSTER 下列所有權限：
  • 該應用程式是 Automotive 的系統應用程式。
  • 只有原始設備製造商 (OEM) 才能為應用程式授予這個角色。
  • 應用程式可為汽車儀表板螢幕 (通常位於方向盤旁) 提供功能，讓使用者接聽電話、存取聯絡人清單和通話記錄。
COMPANION_DEVICE_WATCH 應用程式可以提出要求，以連結及管理手錶裝置 (使用 CompanionDeviceManager 類別提供的 API)。當手錶和應用程式透過應用程式提供的使用者介面連線時，使用者就能透過應用程式管理手錶，包括同步處理聯絡人和行事曆，以及管理通知和電話。
SYSTEM_AUTOMOTIVE_PROJECTION 以下所有項目：
  • 應用程式是系統應用程式。
  • 只有原始設備製造商 (OEM) 才能為應用程式授予這個角色。
  • 這個應用程式可讓手機螢幕投放到車內螢幕上。可讓駕駛人使用車輛的輸入機制 (包括觸控、方向盤控制項和語音指令) 存取及控制 Android 手機上的應用程式，包括音樂、導航、通話和搜尋。
SYSTEM_SHELL 以下所有項目：
  • 應用程式是獲派 Process.SHELL_UID UID 的系統應用程式。
  • 只有原始設備製造商 (OEM) 可以將這個角色授予應用程式。
  • 這款應用程式提供的介面可在指令列層級運作，讓使用者與 Android 作業系統互動。例如顯示資料夾的內容或啟動應用程式。應用程式 (已授予必要權限) 或 ADB 工具可透過程式輔助方式執行 Shell 指令。
SYSTEM_CONTACTS 以下所有項目：
  • 應用程式是系統應用程式。
  • 只有原始設備製造商 (OEM) 可以將這個角色授予應用程式。
  • 應用程式提供使用者介面，方便使用者管理聯絡人 (例如查看、分享、新增、移除或搜尋聯絡人)。使用者透過應用程式更新聯絡人時，應用程式會更新聯絡人提供者。使用者也可以透過應用程式，撥打電話、傳送電子郵件或簡訊給聯絡人。
SYSTEM_SPEECH_RECOGNIZER 以下所有項目：
  • 應用程式是系統應用程式。
  • 只有原始設備製造商 (OEM) 可以將這個角色授予應用程式。
  • 應用程式提供可執行語音辨識的服務。
  • 當應用程式從另一個應用程式接收到用於語音辨識的即時麥克風串流時，會將麥克風使用情況正確歸因於呼叫應用程式，並據此更新應用程式作業統計資料。
SYSTEM_WIFI_COEX_MANAGER 下列所有權限：
  • 應用程式是系統應用程式。
  • 只有原始設備製造商 (OEM) 可以將這個角色授予應用程式。
  • 應用程式提供的服務會動態設定 Wi-Fi 頻道清單，裝置應避免使用這些頻道，以免受到行動網路干擾。
SYSTEM_WELLBEING 以下所有項目：
  • 應用程式是系統應用程式。
  • 只有原始設備製造商 (OEM) 可以將這個角色授予應用程式。
  • 應用程式應為使用者提供減少干擾的功能，並提供使用者有關裝置使用情形的統計資料，例如每週螢幕時間。
SYSTEM_TELEVISION_NOTIFICATION_HANDLER 下列所有權限：
  • 應用程式是系統應用程式。
  • 只有原始設備製造商 (OEM) 可以將這個角色授予應用程式。
  • 應用程式必須在電視裝置上向使用者顯示快訊通知。應用程式也必須在傳送 android.app.action.TOGGLE_NOTIFICATION_HANDLER_PANEL 意圖 (來自 SystemUI) 時顯示目前的有效通知。
SYSTEM_COMPANION_DEVICE_PROVIDER 以下所有項目：
  • 應用程式是系統應用程式。
  • 只有原始設備製造商 (OEM) 可以將這個角色授予應用程式。
  • 應用程式必須能夠偵測附近的周邊裝置。應用程式必須提供使用者介面，讓使用者確認應將特定周邊裝置與應用程式建立關聯並由應用程式管理。在使用者確認後，管理應用程式會授予相關應用程式存取周邊裝置的權限 (例如裝置名稱、位址、類別和綁定狀態)，並開始綁定程序。
SYSTEM_DOCUMENT_MANAGER 以下所有項目：
  • 應用程式是系統應用程式。
  • 只有原始設備製造商 (OEM) 可以將這個角色授予應用程式。
  • 應用程式提供活動，讓使用者存取現有文件，以及在裝置上建立新文件。
  • 應用程式必須符合 Android CDD 部分 2.2.3 中所述的所有規定。軟體 在「[3.2.3.1/H-0-1]」標題下方。
SYSTEM_ACTIVITY_RECOGNIZER 下列所有權限：
SYSTEM_UI 以下所有項目：
  • 應用程式是系統應用程式。
  • 只有原始設備製造商 (OEM) 可以將這個角色授予應用程式。
  • 應用程式提供可讓使用者與手機互動的介面。例如手機的主畫面、導航、最近使用的應用程式、快速設定、通知列、螢幕鎖定、音量控制。
SYSTEM_TELEVISION_REMOTE_SERVICE 以下所有項目：
  • 應用程式是 Android TV 上的系統應用程式。
  • 只有原始設備製造商 (OEM) 可以將這個角色授予應用程式。
  • 應用程式提供的服務可與電視遙控器控制 HID 裝置 (例如透過 BLE) 通訊、注入事件 (例如按鈕點擊)，以及將其他資料 (例如遙控器內建麥克風的音訊串流) 傳送至平台。
SYSTEM_UI_INTELLIGENCE 以下所有項目：
  • 這是預先安裝的服務，可透過架構 API (公開或系統 API) 提供裝置端智慧處理器，用於系統 UI 功能 (例如預測並顯示下一個應用程式給使用者)。
  • 服務必須符合 Android CDD 部分 9.8.6 內容擷取中列出的所有規定。
  • 服務無法擁有 android.permission.INTERNET 權限。而是必須透過開放原始碼專案中明確定義的 API 存取網際網路。
  • 服務無法繫結至應用程式，但以下系統應用程式除外：Bluetooth、Contacts、Media、Telephony、SystemUI 和提供網際網路 API 的元件。每個允許的繫結都必須透過系統設定中的 <allow-association> 設定明確設定。
  • 除非使用者能直接執行操作 (例如，使用者每次分享資料時明確按下按鈕)，否則服務無法與應用程式分享資料。
SYSTEM_AMBIENT_AUDIO_INTELLIGENCE 以下所有項目：
  • 與 SYSTEM_UI_INTELLIGENCE 的條件相同，但預先安裝的服務會提供裝置端智慧處理器，用於處理環境音訊 (例如，辨識裝置附近播放的歌曲)。
SYSTEM_AUDIO_INTELLIGENCE 以下所有項目：
  • 與 SYSTEM_UI_INTELLIGENCE 的條件相同，但預先安裝的服務會提供裝置端智慧音訊處理器 (例如為影片、Podcast、電話通話、視訊通話和語音訊息加上字幕)。
SYSTEM_NOTIFICATION_INTELLIGENCE 以下所有項目：
  • 與 SYSTEM_UI_INTELLIGENCE 的條件相同，但預先安裝的服務會提供裝置端智慧通知處理器 (例如建議回覆訊息通知的回覆和動作)。
SYSTEM_TEXT_INTELLIGENCE 以下所有項目：
  • 與 SYSTEM_UI_INTELLIGENCE 的條件相同，但預先安裝的服務會為文字提供裝置端智慧處理器 (例如提供即時翻譯或自動填入)。
SYSTEM_VISUAL_INTELLIGENCE 以下所有項目：
  • 與 SYSTEM_UI_INTELLIGENCE 的條件相同，但預先安裝的服務會提供裝置端智慧型處理器，用於處理涉及分析攝影機資料的視覺功能。舉例來說，在使用者觀看手機螢幕時保持螢幕開啟，或是根據裝置前置鏡頭拍攝的使用者臉部方向，判斷理想的螢幕方向。
COMPANION_DEVICE_APP_STREAMING 下列所有權限：
  • 應用程式是系統應用程式。
  • 只有原始設備製造商 (OEM) 可以將這個角色授予應用程式。
  • Android 15 以上版本
    建立從裝置 A 到裝置 B 的初始連線時：
    兩部裝置的 AccountManager 中都必須至少有一個相符的帳戶，且配對必須透過一次性代碼確認。
    • 配對裝置時，使用者必須在次要遠端裝置上確認帳戶密碼
    • 一次性代碼必須顯示在來源裝置上，並在已連結的裝置上輸入。
    • 串流播放時不受範圍限制。

    或者，裝置 A 和裝置 B 必須位於藍牙連線範圍內，且串流必須使用一次性代碼授權。
    • 一次性驗證碼會顯示在來源裝置上，並輸入至已連結的裝置。
    • 在串流期間，裝置必須位於彼此的藍牙連線範圍內。
  • 應用程式可以建立及管理已連結裝置的通訊管道，以便交換資料。應用程式和連線裝置必須成功相互驗證 (例如證明彼此知道共用金鑰)，才能建立這些通訊管道。通訊管道必須有加密保護機制。
  • 應用程式可將通知從本機裝置傳送至已連結的裝置，讓使用者在已連結的裝置上採取行動。
  • 能夠將應用程式串流播放所需的中繼資料串流至已連結的裝置，例如區域裝置上可用的應用程式清單。
  • 在使用者明確同意 (在手機或已連結裝置上) 後，能夠從本機裝置串流應用程式至已連結裝置。
  • 能夠在已連結裝置上，將發生在串流應用程式上的事件重播 (插入) 回本機裝置。舉例來說，您可以在手機的相同座標，在平板電腦上重播觸控事件。
  • 當應用程式正在使用麥克風時，應用程式可以將本機裝置的麥克風串流取代為已連線裝置的麥克風串流。
  • 應用程式會擷取裝置的音訊，並串流至已連結的裝置。
  • 當串流應用程式使用相機時，必須封鎖本機裝置的相機串流。
  • 必須驗證已連結裝置的 OS 版本完整性 (例如，使用 VerifiedBootState 中的裝置認證)。
  • 在兩部裝置上，只有在裝置端帳戶註冊表中只有一個相符帳戶的應用程式 (例如 Android 上的 AccountManager 類別) 才能串流。如果情況不同，您必須使用來源裝置顯示的一次性代碼授權串流，並在已連結的裝置上輸入該代碼。請注意，如果裝置支援多位使用者 (而非多個帳戶)，且採用與 Android 多使用者 相同的可靠資料隔離機制，則使用者會計為一台裝置。
  • 如果連結裝置上的帳戶驗證過期或遭到撤銷，必須立即停止串流及中斷連線裝置的連線。
  • 如果使用者 5 分鐘內未與已連結的裝置互動 (例如鍵盤、觸控螢幕和滑鼠處於閒置狀態)，就必須中斷目前的應用程式串流工作階段。影片串流應用程式不受這項規定限制。
  • 從 Android 15 開始
    必須在顯示內容可見的遠端裝置閒置逾時後，中斷所有虛擬裝置的連線。可能會讓遠端裝置螢幕保持開啟，例如 WakeLock 會讓 Android 裝置的螢幕保持開啟。必須提供閒置逾時時間。如果遠端裝置本身沒有閒置逾時時間，則必須使用最多 5 分鐘的閒置逾時時間。
  • 如果來源裝置使用螢幕鎖定知識因子 (LSKF)，在螢幕鎖定時，應用程式不得將應用程式串流至已連結的裝置，除非該裝置有螢幕鎖定功能且已解鎖。
  • 如果裝置由管理員管理，應用程式必須遵守管理員設定的政策，例如在 Android 中使用 DevicePolicyManager 設定，啟用或停用應用程式串流至鄰近裝置。
  • 必須確保遠端顯示畫面和所有遠端輸入事件來源，從使用者的角度來看，兩者都屬於相同的邏輯裝置 (例如遠端螢幕和已連接的鍵盤)，並據此轉送事件。
  • 使用者必須能夠透過本機裝置結束串流，例如使用持續通知中的按鈕。如果手機已設定螢幕鎖定，這項行為會受到鎖定畫面的限制。自 Android 15 起，必須在本機裝置上顯示這個持續性操作元素，且該裝置必須一律可見且位於版面上方。
  • 在其他裝置上進行串流時，必須在來源裝置上顯示操作提示，例如狀態列中的圖示或持續性通知。
DEVICE_POLICY_MANAGEMENT 以下所有項目：
  • 只有原始設備製造商 (OEM) 可以為應用程式授予這個角色。這個角色需要在裝置出貨時，直接授予原始設備製造商 (OEM) 定義的套件名稱，因此應用程式無法要求取得該角色。
  • 應用程式必須能夠佈建受管理的設定檔 (設定檔擁有者) 或受管理的裝置 (裝置擁有者)，包括下載及安裝適當的 Device Policy 用戶端，以便在必要時成為裝置/設定檔擁有者。
  • 應用程式可視需要動態更新資源，例如用於裝置政策管理的字串、可繪項目。
  • 應用程式可以是預先安裝的系統應用程式，也可以先下載並安裝，再進行佈建。
  • 在設定檔擁有者佈建案例中，當角色持有人應用程式安裝在特定 Android 使用者上時，必須安裝在該使用者的所有適用設定檔上。
SYSTEM_APP_PROTECTION_SERVICE 以下所有項目：
  • 應用程式是系統應用程式。
  • 應用程式唯一目的是偵測可能有害的應用程式 (例如可能讓使用者、使用者資料或裝置面臨風險的應用程式，例如木馬程式、網路釣魚和間諜軟體應用程式) 或行動垃圾軟體。
  • 應用程式必須滿足 Android CDD 第 9.8.6 節中的所有規定。作業系統層級和環境資料。
  • 應用程式不得宣告 android.permission.INTERNET 一般權限。而是必須透過開放原始碼專案中明確定義的 API 存取網際網路。
  • 應用程式不得綁定其他應用程式，但以下系統應用程式除外：權限控制器，以及提供 Telephony 和 Internet API 的元件。每個允許的繫結都必須透過系統設定中的 <allow-association> 設定明確設定。
  • 除非使用者採取直接動作 (例如每次分享資料時，使用者都明確按下按鈕)，否則應用程式不得與其他應用程式共用資料。
SYSTEM_AUTOMOTIVE_CALENDAR_SYNC_MANAGER 以下所有項目：
  • 應用程式是系統應用程式。
  • 只有原始設備製造商 (OEM) 才能為應用程式授予這個角色。
  • 應用程式必須將日曆資料從使用者的 iOS 或 Android 手機轉移到 Android Auto 裝置。Android Auto 裝置必須將這項日曆資料儲存在日曆供應商中。
  • 應用程式必須在手機上提供 UI 元件，讓使用者可以開啟日曆同步處理功能，並選取要同步的日曆。應用程式必須在手機上提供 UI 元件，讓使用者可以關閉日曆同步處理功能。
  • 應用程式應能在沒有網際網路連線的情況下運作。例如使用直接有線或無線連線。
AUTOMOTIVE_NAVIGATION 以下所有項目：
  • 應用程式含有活動，可透過隱含意圖要求喚醒，顯示使用者的目前位置和周遭環境。
  • 應用程式含有可透過隱含意圖要求叫用的活動，可讓使用者前往指定地理位置。
  • 應用程式具有導覽焦點時，會在儀表叢集上啟動一個活動。活動必須顯示使用者的目前位置、周遭環境，並讓使用者前往指定地理位置。
COMPANION_DEVICE_COMPUTER 以下所有項目：
  • 應用程式是系統應用程式。
  • 只有原始設備製造商 (OEM) 可以將這個角色授予應用程式。
  • 讓使用者在已連結的電腦上，鏡像顯示手機的通知，並存取手機的相片和媒體。
SYSTEM_SETTINGS_INTELLIGENCE 至少符合下列其中一項條件：
  • 應用程式是系統應用程式。
  • 只有原始設備製造商 (OEM) 才能為應用程式授予這個角色。
  • 提供可為「設定」應用程式提供智慧功能的服務，例如建議和搜尋。
NOTES 以下所有項目：
COMPANION_DEVICE_GLASSES 應用程式可以使用 CompanionDeviceManager 類別提供的 API，發出相關聯的要求，並用來管理眼鏡裝置。使用者可透過 CDM 提供的 UI 連結眼鏡裝置和應用程式，然後將聯絡人存取權和管理通知和電話通話權限授予眼鏡裝置，以便管理眼鏡裝置。
COMPANION_DEVICE_NEARBY_DEVICE_STREAMING 以下所有項目：
  • 應用程式是系統應用程式。
  • 只有原始設備製造商 (OEM) 可以將這個角色授予應用程式。
  • Android 15 以上版本
    建立從裝置 A 到裝置 B 的初始連線時：
    兩部裝置的 AccountManager 中都必須至少有一個相符的帳戶，且配對必須透過一次性代碼確認。
    • 配對裝置時，使用者必須在次要遠端裝置上確認帳戶密碼
    • 一次性代碼必須顯示在來源裝置上，並在已連結的裝置上輸入。
    • 串流播放時不受範圍限制。

    或者，裝置 A 和裝置 B 必須位於藍牙連線範圍內，且串流必須使用一次性代碼授權。
    • 一次性驗證碼會顯示在來源裝置上，並輸入至已連結的裝置。
    • 在串流期間，裝置必須位於彼此的藍牙連線範圍內。
  • 應用程式可以建立及管理已連結裝置的通訊管道，以便裝置交換資料。應用程式和連結的裝置必須成功進行驗證 (例如證明裝置具備共用金鑰)，才能建立這些通訊管道。通訊管道必須具備端對端加密保護機制。
  • 應用程式可將通知從本機裝置傳送至已連結的裝置，讓使用者在已連結的裝置上採取行動。
  • 能夠將應用程式串流播放所需的中繼資料串流至已連結的裝置，例如區域裝置上可用的應用程式清單。
  • 在使用者明確同意 (在手機或已連結裝置上) 後，能夠從本機裝置串流應用程式至已連結裝置。
  • 能夠在本機裝置上重播 (插入) 串流應用程式發生的串流事件。例如，在平板電腦上重播與手機相同座標的觸控事件，或是重播在眼鏡裝置上發生的輸入事件，並使用與手機相同的輸入語義。
  • 當應用程式正在使用麥克風時，應用程式可以將本機裝置的麥克風串流取代為已連線裝置的麥克風串流。
  • 應用程式會擷取裝置的音訊，並串流至已連結的裝置。
  • 必須驗證已連結裝置的 OS 版本完整性 (例如，使用 VerifiedBootState 中的裝置認證)。
  • 在兩部裝置上，只有在裝置端帳戶註冊表中只有一個相符帳戶的應用程式 (例如 Android 上的 AccountManager 類別) 才能串流。如果不是這種情況，則必須使用來源裝置上顯示的一次性代碼授權，並在已連結的裝置上輸入該代碼。請注意，如果裝置支援多位使用者 (而非多個帳戶)，且採用與 Android 多使用者 相同的可靠資料隔離機制，則使用者會計為一台裝置。
  • 如果已連結裝置上的帳戶驗證已到期或遭到撤銷，必須立即停止串流並中斷連線。
  • 如果來源裝置使用 LSKF，在螢幕鎖定時，應用程式不得將應用程式串流至已連結的裝置，除非該裝置有鎖定畫面且已解鎖。
  • 如果裝置由管理員管理，應用程式必須遵循管理員設定的政策，例如啟用或停用對鄰近裝置的串流功能 (例如，在 Android 中使用 DevicePolicyManager 設定)。
  • 必須確保遠端顯示器和所有遠端輸入事件來源，從使用者角度來看，都屬於同一個邏輯裝置 (例如遠端顯示器和已連線的鍵盤)，並且相應地將事件導向。
  • 使用者必須能夠從本機裝置結束串流，例如，在永久通知中使用按鈕。如果手機已設定螢幕鎖定，這項行為會受到鎖定畫面的限制。
  • 在其他裝置上進行串流時，必須在來源裝置上顯示操作提示，例如狀態列中的圖示或持續性通知。
WALLET 下列任一項：
  • 應用程式含有 NFC APDU 服務，可在「付款」類別中靜態註冊至少一個 AID。
  • 應用程式實作 QuickAccessWalletService 的執行個體。