IsolatedService

public abstract class IsolatedService
extends Service

java.lang.Object
   ↳ android.content.Context
     ↳ android.content.ContextWrapper
       ↳ android.app.Service
         ↳ android.adservices.ondevicepersonalization.IsolatedService


基礎類別,用於 ODP 在呼叫 OnDevicePersonalizationManager#execute(ComponentName, PersistableBundle, java.util.concurrent.Executor, OutcomeReceiver) 時啟動服務,並在隔離程序中執行。這項服務可產生內容,以便在呼叫應用程式的 SurfaceView 中顯示,並將持續性結果寫入裝置端儲存空間,供聯合數據分析進行跨裝置統計分析,或供聯合學習進行模型訓練。用戶端應用程式會使用 OnDevicePersonalizationManagerIsolatedService 互動。

摘要

繼承常數

int START_CONTINUATION_MASK

onStartCommand(Intent, int, int) 傳回的位元,說明如何在服務遭到終止時繼續服務。

int START_FLAG_REDELIVERY

如果意圖是先前傳送意圖的重新傳送,則會在 onStartCommand(Intent, int, int) 中設定此標記,因為服務先前已傳回 START_REDELIVER_INTENT,但在呼叫該意圖的 stopSelf(int) 之前已遭到終止。

int START_FLAG_RETRY

如果 Intent 是重試的,因為原始嘗試作業從未收回或從 onStartCommand(android.content.Intent, int, int) 傳回,這個旗標會設定在 onStartCommand(Intent, int, int) 中。

int START_NOT_STICKY

onStartCommand(Intent, int, int) 傳回的常數:如果這項服務的處理程序在啟動時 (從 onStartCommand(Intent, int, int) 傳回後) 遭到終止,且沒有要傳送給它的新啟動意圖,則請將服務從啟動狀態移除,並在日後明確呼叫 Context.startService(Intent) 時才重新建立。

int START_REDELIVER_INTENT

onStartCommand(Intent, int, int) 傳回的常數:如果此服務的程序在啟動時 (從 onStartCommand(Intent, int, int) 傳回後) 遭到終止,則會排定重新啟動,並透過 onStartCommand(Intent, int, int) 再次將上次傳送的意圖重新傳送至該服務。

int START_STICKY

onStartCommand(Intent, int, int) 傳回的常數:如果這項服務的程序在啟動時 (從 onStartCommand(Intent, int, int) 傳回後) 遭到終止,請將其留在已啟動狀態,但不保留此已傳送的意圖。

int START_STICKY_COMPATIBILITY

onStartCommand(Intent, int, int) 傳回的常數:START_STICKY 的相容性版本,不保證 onStartCommand(Intent, int, int) 會在遭到終止後再次呼叫。

int STOP_FOREGROUND_DETACH

stopForeground(int) 的選取器:如果已設定,先前提供給 startForeground(int, Notification) 的通知就會從服務的生命週期中卸離。

int STOP_FOREGROUND_LEGACY

此常數已在 API 級別 33 淘汰。請改用 STOP_FOREGROUND_DETACH。舊版行為不一致,導致無法預測結果的錯誤。

int STOP_FOREGROUND_REMOVE

stopForeground(int) 的選取器:如果提供,先前提供給 startForeground(int, Notification) 的通知會取消並從顯示畫面中移除。

String ACCESSIBILITY_SERVICE

搭配 getSystemService(java.lang.String) 使用,以便擷取 AccessibilityManager,透過已註冊的事件監聽器,為使用者提供 UI 事件的意見回饋。

String ACCOUNT_SERVICE

搭配 getSystemService(java.lang.String) 使用即可擷取 AccountManager,在您選擇的時間點接收意圖。

String ACTIVITY_SERVICE

getSystemService(java.lang.String) 搭配使用時,可擷取 ActivityManager 來與全域系統狀態互動。

String ALARM_SERVICE

搭配 getSystemService(java.lang.String) 使用,即可擷取 AlarmManager,以便在您指定的時間接收意圖。

String APPWIDGET_SERVICE

getSystemService(java.lang.String) 搭配使用,可擷取 AppWidgetManager 來存取 AppWidget。

String APP_OPS_SERVICE

getSystemService(java.lang.String) 搭配使用時,可擷取 AppOpsManager,用於追蹤裝置上的應用程式作業。

String APP_SEARCH_SERVICE

使用 getSystemService(java.lang.String) 擷取 AppSearchManager,以建立索引及查詢系統管理的應用程式資料。

String AUDIO_SERVICE

搭配 getSystemService(java.lang.String) 使用,可擷取 AudioManager 來處理音量、鈴聲模式和音訊路由的管理作業。

String BATTERY_SERVICE

getSystemService(java.lang.String) 搭配使用,擷取 BatteryManager 來管理電池狀態。

int BIND_ABOVE_CLIENT

bindService(Intent, BindServiceFlags, Executor, ServiceConnection) 的標記:表示用戶端應用程式繫結至此服務時,會將服務視為比應用程式本身更重要的項目。

int BIND_ADJUST_WITH_ACTIVITY

bindService(Intent, BindServiceFlags, Executor, ServiceConnection) 的旗標:如果是與活動建立繫結,則無論使用者能否看到活動,或是否使用其他旗標來減少用於降低用戶端程序整體重要性的影響程度,就應允許目標服務的程序重要性。

int BIND_ALLOW_ACTIVITY_STARTS

bindService(Intent, BindServiceFlags, Executor, ServiceConnection) 的標記:如果從開放瀏覽權限的應用程式進行綁定,則綁定的服務可從背景啟動活動。

int BIND_ALLOW_OOM_MANAGEMENT

bindService(Intent, BindServiceFlags, Executor, ServiceConnection) 的標記:允許代管已繫結服務的程序進行正常的記憶體管理。

int BIND_AUTO_CREATE

bindService(Intent, BindServiceFlags, Executor, ServiceConnection) 的標記:只要繫結項存在,就會自動建立服務。

int BIND_DEBUG_UNBIND

bindService(Intent, BindServiceFlags, Executor, ServiceConnection) 的標記:針對不相符的解除綁定呼叫,納入偵錯說明。

int BIND_EXTERNAL_SERVICE

bindService(Intent, BindServiceFlags, Executor, ServiceConnection) 的標記:所繫結的服務是 isolatedexternal 服務。

long BIND_EXTERNAL_SERVICE_LONG

運作方式與 BIND_EXTERNAL_SERVICE 相同,但定義為與 BindServiceFlags 相容的 (@code long) 值。

int BIND_IMPORTANT

bindService(Intent, BindServiceFlags, Executor, ServiceConnection) 的標記:這項服務對用戶端非常重要,因此應在用戶端處於前景程序層級時,將其帶入前景程序層級。

int BIND_INCLUDE_CAPABILITIES

bindService(Intent, BindServiceFlags, Executor, ServiceConnection) 的標記:如果從具有特定功能的應用程式 (因其前景狀態而具有特定功能,例如活動或前景服務) 進行繫結,只要繫結的應用程式也具有必要的權限,這個標記就會允許繫結的應用程式取得相同的功能。

int BIND_NOT_FOREGROUND

bindService(Intent, BindServiceFlags, Executor, ServiceConnection) 的標記:不允許此繫結將目標服務的程序提升至前景排程優先順序。

int BIND_NOT_PERCEPTIBLE

bindService(Intent, BindServiceFlags, Executor, ServiceConnection) 旗標:如果繫結的應用程式為可見或使用者可察覺的應用程式,請將目標服務的重要性降低至低於可察覺的程度。

int BIND_SHARED_ISOLATED_PROCESS

bindIsolatedService(Intent, BindServiceFlags, String, Executor, ServiceConnection) 的標記:將服務繫結至共用的隔離程序。

int BIND_WAIVE_PRIORITY

bindService(Intent, BindServiceFlags, Executor, ServiceConnection) 的旗標:不會影響目標服務託管程序的排程或記憶體管理優先順序。

String BIOMETRIC_SERVICE

使用 getSystemService(java.lang.String) 擷取 BiometricManager,以處理生物特徵辨識和 PIN 碼/圖案/密碼驗證作業。

String BLOB_STORE_SERVICE

搭配 getSystemService(java.lang.String) 使用,即可擷取 BlobStoreManager,用於從系統維護的 blob 儲存庫中提交及存取資料 blob。

String BLUETOOTH_SERVICE

搭配 getSystemService(java.lang.String) 使用,可擷取用於使用藍牙的 BluetoothManager

String BUGREPORT_SERVICE

用於擷取錯誤報告的服務。

String CAMERA_SERVICE

使用 getSystemService(java.lang.String) 擷取用於與相機裝置互動的 CameraManager

String CAPTIONING_SERVICE

搭配 getSystemService(java.lang.String) 使用,可擷取 CaptioningManager 來取得字幕屬性,並監聽字幕偏好的變更。

String CARRIER_CONFIG_SERVICE

getSystemService(java.lang.String) 搭配使用,擷取 CarrierConfigManager 來讀取電信業者設定值。

String CLIPBOARD_SERVICE

搭配 getSystemService(java.lang.String) 使用,可擷取 ClipboardManager,用於存取及修改全域剪貼簿的內容。

String COMPANION_DEVICE_SERVICE

getSystemService(java.lang.String) 搭配使用時,可擷取 CompanionDeviceManager 來管理隨附裝置

String CONNECTIVITY_DIAGNOSTICS_SERVICE

使用 getSystemService(java.lang.String) 擷取 ConnectivityDiagnosticsManager,以便執行網路連線診斷,以及接收系統中的網路連線資訊。

String CONNECTIVITY_SERVICE

搭配 getSystemService(java.lang.String) 使用,即可擷取 ConnectivityManager,用於處理網路連線管理作業。

String CONSUMER_IR_SERVICE

使用 getSystemService(java.lang.String) 擷取 ConsumerIrManager,以便從裝置傳輸紅外線信號。

int CONTEXT_IGNORE_SECURITY

createPackageContext(String, int) 搭配使用的旗標:忽略對所要求的 Context 的任何安全限制,讓該 Context 一律可載入。

int CONTEXT_INCLUDE_CODE

搭配 createPackageContext(String, int) 使用的標記:在結構定義中加入應用程式程式碼。

int CONTEXT_RESTRICTED

createPackageContext(String, int) 搭配使用的旗標:受限的內容可能會停用特定功能。

String CREDENTIAL_SERVICE

搭配 getSystemService(java.lang.String) 使用,即可擷取 CredentialManager,為應用程式驗證使用者。

String CROSS_PROFILE_APPS_SERVICE

getSystemService(java.lang.String) 搭配使用,擷取跨設定檔作業的 CrossProfileApps

int DEVICE_ID_DEFAULT

預設裝置 ID,即主要 (非虛擬) 裝置的 ID。

int DEVICE_ID_INVALID

裝置 ID 無效。

String DEVICE_LOCK_SERVICE

搭配 getSystemService(java.lang.String) 使用,即可擷取 DeviceLockManager

String DEVICE_POLICY_SERVICE

搭配 getSystemService(java.lang.String) 使用,以便擷取 DevicePolicyManager 來處理全域裝置政策管理作業。

String DISPLAY_HASH_SERVICE

搭配 getSystemService(java.lang.String) 使用,以便存取 DisplayHashManager 來處理顯示雜湊。

String DISPLAY_SERVICE

getSystemService(java.lang.String) 搭配使用時,可擷取 DisplayManager 來與顯示裝置互動。

String DOMAIN_VERIFICATION_SERVICE

搭配 getSystemService(java.lang.String) 使用,即可存取 DomainVerificationManager,擷取已宣告網域的核准狀態和使用者狀態。

String DOWNLOAD_SERVICE

搭配 getSystemService(java.lang.String) 使用,即可擷取 DownloadManager 來要求 HTTP 下載作業。

String DROPBOX_SERVICE

搭配 getSystemService(java.lang.String) 使用,可擷取 DropBoxManager 例項,用於記錄診斷記錄檔。

String EUICC_SERVICE

搭配 getSystemService(java.lang.String) 使用,即可擷取 EuiccManager 來管理裝置 eUICC (嵌入式 SIM 卡)。

String FILE_INTEGRITY_SERVICE

搭配 getSystemService(java.lang.String) 使用,即可擷取 FileIntegrityManager

String FINGERPRINT_SERVICE

搭配 getSystemService(java.lang.String) 使用,以便擷取 FingerprintManager 來處理指紋管理作業。

String GAME_SERVICE

搭配 getSystemService(java.lang.String) 使用,即可擷取 GameManager

String GRAMMATICAL_INFLECTION_SERVICE

搭配 getSystemService(java.lang.String) 使用,即可擷取 GrammaticalInflectionManager

String HARDWARE_PROPERTIES_SERVICE

搭配 getSystemService(java.lang.String) 使用,即可擷取 HardwarePropertiesManager,用於存取硬體屬性服務。

String HEALTHCONNECT_SERVICE

getSystemService(java.lang.String) 搭配使用,擷取 HealthConnectManager

String INPUT_METHOD_SERVICE

搭配 getSystemService(java.lang.String) 使用,以便擷取 InputMethodManager 來存取輸入方法。

String INPUT_SERVICE

使用 getSystemService(java.lang.String) 擷取與輸入裝置互動的 InputManager

String IPSEC_SERVICE

getSystemService(java.lang.String) 搭配使用,可擷取 IpSecManager,以便使用 IPSec 加密 Socket 或網路。

String JOB_SCHEDULER_SERVICE

搭配 getSystemService(java.lang.String) 使用,即可擷取 JobScheduler 例項,用於管理偶發的背景工作。

String KEYGUARD_SERVICE

getSystemService(java.lang.String) 搭配使用即可擷取用於控制鍵盤保護的 KeyguardManager

String LAUNCHER_APPS_SERVICE

搭配 getSystemService(java.lang.String) 使用,擷取 LauncherApps,以便在使用者的各個設定檔中查詢及監控可啟動的應用程式。

String LAYOUT_INFLATER_SERVICE

搭配 getSystemService(java.lang.String) 使用,即可擷取 LayoutInflater,用於在這個情境中加載版面配置資源。

String LOCALE_SERVICE

搭配 getSystemService(java.lang.String) 使用,即可擷取 LocaleManager

String LOCATION_SERVICE

使用 getSystemService(java.lang.String) 擷取 LocationManager,以控制位置更新通知。

String MEDIA_COMMUNICATION_SERVICE

getSystemService(java.lang.String) 搭配使用,擷取用於管理 MediaSession2MediaCommunicationManager

String MEDIA_METRICS_SERVICE

getSystemService(java.lang.String) 搭配使用時,可擷取 MediaMetricsManager,用於與裝置上的媒體指標互動。

String MEDIA_PROJECTION_SERVICE

搭配 getSystemService(java.lang.String) 使用,以便擷取 MediaProjectionManager 例項,用於管理媒體投影工作階段。

String MEDIA_ROUTER_SERVICE

搭配 getSystemService(Class) 使用,可擷取 MediaRouter,用於控制及管理媒體路由。

String MEDIA_SESSION_SERVICE

搭配 getSystemService(java.lang.String) 使用,即可擷取 MediaSessionManager 來管理媒體工作階段。

String MIDI_SERVICE

搭配 getSystemService(java.lang.String) 使用,即可擷取 MidiManager 來存取 MIDI 服務。

int MODE_APPEND

檔案建立模式:與 openFileOutput(String, int) 搭配使用時,如果檔案已存在,則將資料寫入現有檔案的結尾,而非將其刪除。

int MODE_ENABLE_WRITE_AHEAD_LOGGING

資料庫開啟旗標:設定完成後,資料庫會預設為啟用預先寫入記錄功能。

int MODE_MULTI_PROCESS

API 級別 23 已淘汰此常數。 MODE_MULTI_PROCESS 在某些 Android 版本中無法正常運作,而且也不提供任何機制,用於在不同程序中協調並行修改作業。應用程式不應嘗試使用該值。而是應使用明確的跨程序資料管理方法,例如 ContentProvider

int MODE_NO_LOCALIZED_COLLATORS

資料庫開啟標記:設定後,系統會開啟資料庫,但不支援本地化排序器。

int MODE_PRIVATE

檔案建立模式:預設模式,只有在呼叫應用程式 (或所有共用相同使用者 ID 的應用程式) 才能存取建立的檔案。

int MODE_WORLD_READABLE

此常數已在 API 級別 17 淘汰。建立可供全球讀取的檔案非常危險,而且可能會導致應用程式出現安全漏洞。強烈建議您不要這樣做;應用程式應針對 ContentProviderBroadcastReceiverService 等互動,採用更正式的機制。我們無法保證檔案會保留此存取模式,例如在備份和還原時。

int MODE_WORLD_WRITEABLE

此常數已在 API 級別 17 淘汰。建立可供所有使用者寫入的檔案非常危險,可能會導致應用程式出現安全漏洞。我們強烈建議您不要使用這項功能;應用程式應改用更正式的互動機制,例如 ContentProviderBroadcastReceiverService。我們無法保證檔案會保留此存取模式,例如在備份和還原時。

String NETWORK_STATS_SERVICE

搭配 getSystemService(java.lang.String) 使用,即可擷取 NetworkStatsManager 來查詢網路使用統計資料。

String NFC_SERVICE

搭配 getSystemService(java.lang.String) 使用,以便擷取 NfcManager 來使用 NFC。

String NOTIFICATION_SERVICE

搭配 getSystemService(java.lang.String) 使用,可擷取 NotificationManager,用於通知使用者背景事件。

String NSD_SERVICE

搭配 getSystemService(java.lang.String) 使用,以便擷取 NsdManager,處理網路服務探索的管理作業

String OVERLAY_SERVICE

getSystemService(java.lang.String) 搭配使用,擷取 OverlayManager 來管理重疊套件。

String PEOPLE_SERVICE

搭配 getSystemService(java.lang.String) 使用,即可存取 PeopleManager,與已發布的對話互動。

String PERFORMANCE_HINT_SERVICE

搭配 getSystemService(java.lang.String) 使用,以便擷取 PerformanceHintManager 來存取效能提示服務。

String POWER_SERVICE

使用 getSystemService(java.lang.String) 擷取用於控制電源管理的 PowerManager,包括「Wake Lock」,讓裝置在執行長時間工作時保持開啟狀態。

String PRINT_SERVICE

PrintManager:用於列印及管理印表機和列印工作。

int RECEIVER_EXPORTED

registerReceiver(BroadcastReceiver, IntentFilter) 的標記:接收器可接收其他應用程式的廣播訊息。

int RECEIVER_NOT_EXPORTED

registerReceiver(BroadcastReceiver, IntentFilter) 的標記:接收器無法接收其他應用程式的廣播訊息。

int RECEIVER_VISIBLE_TO_INSTANT_APPS

registerReceiver(BroadcastReceiver, IntentFilter) 旗標:接收器可接收來自免安裝應用程式的廣播訊息。

String RESTRICTIONS_SERVICE

搭配 getSystemService(java.lang.String) 使用,即可擷取 RestrictionsManager,用於擷取應用程式限制,以及要求受限制作業的權限。

String ROLE_SERVICE

搭配 getSystemService(java.lang.String) 使用,可擷取用於管理角色的 RoleManager

String SEARCH_SERVICE

搭配 getSystemService(java.lang.String) 使用,可擷取 SearchManager 來處理搜尋作業。

String SENSOR_SERVICE

getSystemService(java.lang.String) 搭配使用時,可擷取 SensorManager 來存取感應器。

String SHORTCUT_SERVICE

getSystemService(java.lang.String) 搭配使用,擷取 ShortcutManager 以存取啟動器捷徑服務。

String STATUS_BAR_SERVICE

getSystemService(java.lang.String) 搭配使用時,可擷取 StatusBarManager,用於與狀態列和快速設定互動。

String STORAGE_SERVICE

搭配 getSystemService(java.lang.String) 使用,以便擷取 StorageManager 來存取系統儲存空間函式。

String STORAGE_STATS_SERVICE

搭配 getSystemService(java.lang.String) 使用,以便擷取 StorageStatsManager 來存取系統儲存空間統計資料。

String SYSTEM_HEALTH_SERVICE

搭配 getSystemService(java.lang.String) 使用,可擷取 SystemHealthManager 來存取系統健康 (電池、電力、記憶體等) 指標。

String TELECOM_SERVICE

getSystemService(java.lang.String) 搭配使用時,可擷取 TelecomManager 來管理裝置的電信相關功能。

String TELEPHONY_IMS_SERVICE

搭配 getSystemService(java.lang.String) 使用,即可擷取 ImsManager

String TELEPHONY_SERVICE

使用 getSystemService(java.lang.String) 擷取 TelephonyManager,以處理裝置的電話功能管理。

String TELEPHONY_SUBSCRIPTION_SERVICE

搭配 getSystemService(java.lang.String) 使用,以便擷取 SubscriptionManager,處理裝置的電話訂閱項目管理作業。

String TEXT_CLASSIFICATION_SERVICE

搭配 getSystemService(java.lang.String) 使用,可為文字分類服務擷取 TextClassificationManager

String TEXT_SERVICES_MANAGER_SERVICE

搭配 getSystemService(java.lang.String) 使用,可擷取 TextServicesManager 來存取文字服務。

String TV_INPUT_SERVICE

getSystemService(java.lang.String) 搭配使用時,可擷取 TvInputManager 來與裝置上的 TV 輸入互動。

String TV_INTERACTIVE_APP_SERVICE

使用 getSystemService(java.lang.String) 擷取 TvInteractiveAppManager,以便在裝置上與電視互動式應用程式互動。

String UI_MODE_SERVICE

搭配 getSystemService(java.lang.String) 使用,即可擷取 UiModeManager 來控制 UI 模式。

String USAGE_STATS_SERVICE

搭配 getSystemService(java.lang.String) 使用,即可擷取 UsageStatsManager 來查詢裝置使用統計資料。

String USB_SERVICE

getSystemService(java.lang.String) 搭配使用,擷取 UsbManager 以存取 USB 裝置 (做為 USB 主機),以及控制這部裝置做為 USB 裝置的行為。

String USER_SERVICE

搭配 getSystemService(java.lang.String) 使用,可擷取 UserManager,用於管理支援多位使用者的裝置。

String VIBRATOR_MANAGER_SERVICE

搭配 getSystemService(java.lang.String) 使用,可擷取 VibratorManager,用於存取裝置震動器、與個別震動器互動,以及在多個震動器上播放同步效果。

String VIBRATOR_SERVICE

此常數已在 API 級別 31 淘汰。使用 VibratorManager 擷取預設系統震動器。

String VIRTUAL_DEVICE_SERVICE

搭配 getSystemService(java.lang.String) 使用即可擷取用於管理虛擬裝置的 VirtualDeviceManager

String VPN_MANAGEMENT_SERVICE

搭配 getSystemService(java.lang.String) 使用,即可擷取 VpnManager,用於管理平台內建 VPN 的設定檔。

String WALLPAPER_SERVICE

getSystemService(java.lang.String) 搭配使用,擷取用於存取桌布的 com.android.server.WallpaperService。

String WIFI_AWARE_SERVICE

搭配 getSystemService(java.lang.String) 使用,以便擷取 WifiAwareManager,處理 Wi-Fi Aware 的管理作業。

String WIFI_P2P_SERVICE

getSystemService(java.lang.String) 搭配使用時,可擷取 WifiP2pManager 來處理 Wi-Fi 點對點連線的管理作業。

String WIFI_RTT_RANGING_SERVICE

搭配 getSystemService(java.lang.String) 使用,可為使用 Wi-Fi 的測距裝置擷取 WifiRttManager

String WIFI_SERVICE

搭配 getSystemService(java.lang.String) 使用,可擷取 WifiManager 來處理 Wi-Fi 存取權的管理作業。

String WINDOW_SERVICE

搭配 getSystemService(java.lang.String) 使用,可擷取 WindowManager 來存取系統的視窗管理員。

int TRIM_MEMORY_BACKGROUND

onTrimMemory(int) 的層級:程序已進入 LRU 清單。

int TRIM_MEMORY_COMPLETE

onTrimMemory(int) 的等級:處理程序即將從背景 LRU 清單中移除,如果很快找不到更多記憶體,系統就會終止該程序。

int TRIM_MEMORY_MODERATE

onTrimMemory(int) 的等級:處理程序位於背景 LRU 清單的中間位置;釋放記憶體有助於系統保留清單中較晚執行的其他程序,進而提升整體效能。

int TRIM_MEMORY_RUNNING_CRITICAL

onTrimMemory(int) 的等級:程序不是可延伸的背景程序,但裝置的記憶體用量極低,預計將無法繼續執行任何背景程序。

int TRIM_MEMORY_RUNNING_LOW

onTrimMemory(int) 的等級:處理程序不是可犧牲的背景程序,但裝置的記憶體不足。

int TRIM_MEMORY_RUNNING_MODERATE

onTrimMemory(int) 的等級:該程序不是可犧牲的背景程序,但裝置的記憶體用量偏低。

int TRIM_MEMORY_UI_HIDDEN

onTrimMemory(int) 的層級:程序曾經顯示使用者介面,但現在已不再顯示。

公用建構函式

IsolatedService()

公用方法

final EventUrlProvider getEventUrlProvider(RequestToken requestToken)

傳回目前要求的 EventUrlProvider

final FederatedComputeScheduler getFederatedComputeScheduler(RequestToken requestToken)

傳回目前要求的 FederatedComputeScheduler

final MutableKeyValueStore getLocalData(RequestToken requestToken)

傳回 LOCAL_DATA 資料表的資料存取物件。

final LogReader getLogReader(RequestToken requestToken)

針對 REQUESTS 和 EVENTS 資料表傳回 DAO,可提供 IsolatedService 可讀取的資料列存取權。

final KeyValueStore getRemoteData(RequestToken requestToken)

傳回 REMOTE_DATA 資料表的資料存取物件。

final UserData getUserData(RequestToken requestToken)

針對目前要求傳回平台提供的 UserData

IBinder onBind(Intent intent)

處理繫結至 IsolatedService 的作業。

void onCreate()

IsolatedService 建立繫結器。

abstract IsolatedWorker onRequest(RequestToken requestToken)

傳回處理用戶端要求的 IsolatedWorker 例項。

繼承方法

void attachBaseContext(Context newBase)

設定這個 ContextWrapper 的基本結構定義。

void dump(FileDescriptor fd, PrintWriter writer, String[] args)

將服務的狀態列印到指定的串流中。

final Application getApplication()

傳回擁有此服務的應用程式。

final int getForegroundServiceType()

如果服務已透過呼叫 startForeground(int, android.app.Notification)startForeground(int, android.app.Notification, int) 成為前景服務,getForegroundServiceType() 會傳回目前的前景服務類型。

abstract IBinder onBind(Intent intent)

將通訊管道傳回服務。

void onConfigurationChanged(Configuration newConfig)

在元件執行期間,當裝置設定有所變更時,系統會呼叫此方法。

void onCreate()

系統在首次建立服務時呼叫。

void onDestroy()

系統會呼叫此事件,通知服務已不再使用且即將移除。

void onLowMemory()

當整體系統的記憶體用量偏低時,系統會呼叫此方法,並且正在執行的程序應減少記憶體用量。

void onRebind(Intent intent)

在先前通知所有 onUnbind(Intent) 已中斷連線後,如果有新的用戶端連線到服務,就會呼叫此方法。

void onStart(Intent intent, int startId)

API 級別 15 已淘汰此方法。請改為實作 onStartCommand(android.content.Intent, int, int)

int onStartCommand(Intent intent, int flags, int startId)

每當用戶端透過呼叫 Context.startService(Intent) 明確啟動服務時,系統就會呼叫此方法,提供所提供的引數,以及代表啟動要求的專屬整數符記。

void onTaskRemoved(Intent rootIntent)

如果服務正在執行中,而使用者移除了服務應用程式傳來的工作,系統就會呼叫此方法。

void onTimeout(int startId)

ServiceInfo#FOREGROUND_SERVICE_TYPE_SHORT_SERVICE 逾時時呼叫的回呼。

void onTrimMemory(int level)

當作業系統判斷程序適合從其程序中裁減不必要的記憶體時,系統會呼叫這個方法。

boolean onUnbind(Intent intent)

當所有用戶端都已與服務發布的特定介面中斷連線時,系統會呼叫此方法。

final void startForeground(int id, Notification notification)

如果服務已啟動 (透過 Context#startService(Intent) 執行),請將這項服務設為在前景執行,並在這個狀態下提供持續通知,向使用者顯示。

final void startForeground(int id, Notification notification, int foregroundServiceType)

startForeground(int, android.app.Notification) 的超載版本,含有額外的 foregroundServiceType 參數。

final void stopForeground(int notificationBehavior)

將這項服務從前景狀態移除,以便在需要更多記憶體時終止服務。

final void stopForeground(boolean removeNotification)

這個方法已在 API 級別 33 淘汰。請改為呼叫 stopForeground(int),並明確傳遞 STOP_FOREGROUND_REMOVESTOP_FOREGROUND_DETACH

final void stopSelf()

如果服務先前已啟動,請停止該服務。

final void stopSelf(int startId)

舊版 stopSelfResult(int) 不會傳回結果。

final boolean stopSelfResult(int startId)

如果服務的上次啟動時間為 startId,請停止服務。

void attachBaseContext(Context base)

為這個 ContextWrapper 設定基本情境。

boolean bindIsolatedService(Intent service, int flags, String instanceName, Executor executor, ServiceConnection conn)

bindService(Intent, BindServiceFlags, Executor, ServiceConnection) 的變化版本,在特定情況下,系統會針對獨立服務,讓呼叫端從單一元件宣告產生服務的多個執行個體。

boolean bindService(Intent service, int flags, Executor executor, ServiceConnection conn)

與用於控制 ServiceConnection 回呼的 bindService(Intent, ServiceConnection, int) 相同。

boolean bindService(Intent service, ServiceConnection conn, Context.BindServiceFlags flags)

請參閱 bindService(android.content.Intent, android.content.ServiceConnection, int) 一文,瞭解如何呼叫 BindServiceFlags#of(long) 取得 BindServiceFlags 物件。

boolean bindService(Intent service, ServiceConnection conn, int flags)

連線至應用程式服務,並視需求建立。

boolean bindService(Intent service, Context.BindServiceFlags flags, Executor executor, ServiceConnection conn)

請參閱 bindService(android.content.Intent, int, java.util.concurrent.Executor, android.content.ServiceConnection) 一節,瞭解如何呼叫 BindServiceFlags#of(long) 以取得 BindServiceFlags 物件。

int checkCallingOrSelfPermission(String permission)

判斷 IPC 的呼叫程序或您是否已獲得特定權限。

int checkCallingOrSelfUriPermission(Uri uri, int modeFlags)

判斷 IPC 的呼叫程序 或您是否已獲得存取特定 URI 的權限。

int[] checkCallingOrSelfUriPermissions(List<Uri> uris, int modeFlags)

判斷 IPC 的呼叫程序 或您是否已獲得存取 URI 清單的權限。

int checkCallingPermission(String permission)

判斷您正在處理的 IPC 呼叫程序是否已獲得特定權限。

int checkCallingUriPermission(Uri uri, int modeFlags)

判斷呼叫程序和使用者 ID 是否已獲得存取特定 URI 的權限。

int[] checkCallingUriPermissions(List<Uri> uris, int modeFlags)

判斷是否已授予呼叫程序和使用者 ID 存取 URI 清單的權限。

int checkPermission(String permission, int pid, int uid)

判斷是否允許特定權限適用於在系統中執行的特定程序和使用者 ID。

int checkSelfPermission(String permission)

判斷系統是否已授予 特定權限。

int checkUriPermission(Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags)

檢查 Uri 和一般權限。

int checkUriPermission(Uri uri, int pid, int uid, int modeFlags)

判斷特定程序和使用者 ID 是否已獲得存取特定 URI 的權限。

int[] checkUriPermissions(List<Uri> uris, int pid, int uid, int modeFlags)

判斷特定程序和使用者 ID 是否已獲得存取 URI 清單的權限。

void clearWallpaper()

這個方法已淘汰。 請改用 WallpaperManager.clear()

此方法需要呼叫端擁有 Manifest.permission.SET_WALLPAPER 權限。

Context createAttributionContext(String attributionTag)

針對目前情境傳回新的 Context 物件,但要歸因於其他標記。

Context createConfigurationContext(Configuration overrideConfiguration)

針對目前情境傳回新的 Context 物件,但其資源會經過調整,以符合指定設定。

Context createContext(ContextParams contextParams)

建立具有特定屬性和行為的內容。

Context createDeviceContext(int deviceId)

從目前的內容傳回新的 Context 物件,但會附帶 deviceId 提供的裝置關聯。

Context createDeviceProtectedStorageContext()

為目前的 Context 傳回新的 Context 物件,但其儲存空間 API 由裝置保護儲存空間提供支援。

Context createDisplayContext(Display display)

從目前的內容傳回新的 Context 物件,但資源會調整為符合 display 的指標。

Context createPackageContext(String packageName, int flags)

傳回指定應用程式名稱的新 Context 物件。

Context createWindowContext(int type, Bundle options)

為非活動視窗建立內容。

Context createWindowContext(Display display, int type, Bundle options)

在指定的 Display 上,為非 activity 視窗建立 Context

String[] databaseList()

傳回字串陣列,命名與這個 Context 應用程式套件相關聯的私人資料庫。

boolean deleteDatabase(String name)

刪除與這個 Context 應用程式套件相關聯的現有私人 SQLiteDatabase。

boolean deleteFile(String name)

刪除與這個情境應用程式套件相關聯的指定私人檔案。

boolean deleteSharedPreferences(String name)

刪除現有的共用偏好設定檔案。

void enforceCallingOrSelfPermission(String permission, String message)

如果您或您所處理的 IPC 呼叫程序未獲得特定權限,請擲回 SecurityException

void enforceCallingOrSelfUriPermission(Uri uri, int modeFlags, String message)

如果 IPC 的呼叫程序 或您未獲得存取特定 URI 的權限,請擲回 SecurityException

void enforceCallingPermission(String permission, String message)

如果您正在處理的 IPC 呼叫程序未獲得特定權限,請擲回 SecurityException

void enforceCallingUriPermission(Uri uri, int modeFlags, String message)

如果呼叫程序和使用者 ID 未獲得存取特定 URI 的權限,請擲回 SecurityException

void enforcePermission(String permission, int pid, int uid, String message)

如果系統中執行的特定程序和使用者 ID 不允許使用指定權限,請擲回 SecurityException

void enforceUriPermission(Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags, String message)

同時強制執行 URI 和一般權限。

void enforceUriPermission(Uri uri, int pid, int uid, int modeFlags, String message)

如果特定程序和使用者 ID 尚未獲得存取特定 URI 的權限,請擲回 SecurityException

String[] fileList()

傳回字串陣列,命名與此 Context 應用程式套件相關聯的私人檔案。

Context getApplicationContext()

傳回目前程序的單一全域 Application 物件內容。

ApplicationInfo getApplicationInfo()

傳回這個結構定義套件的完整應用程式資訊。

AssetManager getAssets()

傳回應用程式套件的 AssetManager 執行個體。

AttributionSource getAttributionSource()

Context getBaseContext()
File getCacheDir()

傳回檔案系統中應用程式專屬快取目錄的絕對路徑。

ClassLoader getClassLoader()

傳回可用於擷取此套件中類別的類別載入器。

File getCodeCacheDir()

傳回專屬於應用程式的快取目錄絕對路徑,該目錄位於專門用於儲存快取程式碼的檔案系統中。

ContentResolver getContentResolver()

針對應用程式的套件傳回 ContentResolver 執行個體。

File getDataDir()

傳回檔案系統中目錄的絕對路徑,此目錄儲存所有屬於此應用程式的私人檔案。

File getDatabasePath(String name)

傳回檔案系統中的絕對路徑,其中儲存了使用 openOrCreateDatabase(String, int, CursorFactory) 建立的資料庫。

int getDeviceId()

取得此情境所關聯的裝置 ID。

File getDir(String name, int mode)

擷取 (視需要建立) 新的目錄,讓應用程式可將自訂資料檔案放入其中。

Display getDisplay()

取得與這個情境相關聯的螢幕。

File getExternalCacheDir()

傳回主要共用/外部儲存裝置中應用程式特定目錄的絕對路徑,讓應用程式可在其中放置自己的快取檔案。

File[] getExternalCacheDirs()

傳回所有共用/外部儲存裝置中應用程式專屬目錄的絕對路徑,應用程式可在該目錄中放置所擁有的快取檔案。

File getExternalFilesDir(String type)

傳回主要共用/外部儲存裝置中目錄的絕對路徑,讓應用程式可在其中放置自有的永久檔案。

File[] getExternalFilesDirs(String type)

傳回所有共用/外部儲存裝置中的應用程式特定目錄的絕對路徑,讓應用程式可在其中放置自有的永久檔案。

File[] getExternalMediaDirs()

這個方法已淘汰。 這些目錄仍會存在並受到掃描,但我們建議開發人員改為直接將內容插入 MediaStore 集合,因為自 Build.VERSION_CODES.Q 起,任何應用程式都可以將新媒體貢獻給 MediaStore,且無需權限。

File getFileStreamPath(String name)

傳回檔案系統中的絕對路徑,其中儲存了使用 openFileOutput(String, int) 建立的檔案。

File getFilesDir()

傳回檔案系統中目錄的絕對路徑,用於儲存使用 openFileOutput(String, int) 建立的檔案。

Executor getMainExecutor()

傳回 Executor,以便在與這個結構定義相關聯的主執行緒上執行已加入佇列的工作。

Looper getMainLooper()

傳回目前程序主執行緒的 Looper。

File getNoBackupFilesDir()

傳回檔案系統中目錄的絕對路徑,類似 getFilesDir()

File getObbDir()

傳回主要共用/外部儲存空間目錄,可在此目錄中找到此應用程式的 OBB 檔案 (如有)。

File[] getObbDirs()

傳回所有共用/外部儲存裝置中,應用程式特定目錄的絕對路徑 (如果有應用程式的 OBB 檔案)。

String getPackageCodePath()

傳回此內容的主要 Android 套件的完整路徑。

PackageManager getPackageManager()

傳回 PackageManager 例項,以便查找全域套件資訊。

String getPackageName()

傳回此應用程式套件的名稱。

String getPackageResourcePath()

傳回此內容的主要 Android 套件的完整路徑。

ContextParams getParams()

如果此 Context 是透過 createContext(android.content.ContextParams) 建立,則傳回用於建立該 Context 的參數集。

Resources getResources()

傳回應用程式套件的 Resources 例項。

SharedPreferences getSharedPreferences(String name, int mode)

擷取並保留偏好設定檔「name」的內容,傳回 SharedPreferences,您可透過該值擷取及修改其值。

Object getSystemService(String name)

依名稱將控制代碼傳回系統層級的服務。

String getSystemServiceName(Class<?> serviceClass)

取得指定類別所代表的系統層級服務名稱。

Resources.Theme getTheme()

傳回與此 Context 相關聯的 Theme 物件。

Drawable getWallpaper()

此方法已淘汰。 請改用 WallpaperManager.get()

int getWallpaperDesiredMinimumHeight()

此方法已淘汰。 請改用 WallpaperManager.getDesiredMinimumHeight()

int getWallpaperDesiredMinimumWidth()

這個方法已淘汰。 請改用 WallpaperManager.getDesiredMinimumWidth()

void grantUriPermission(String toPackage, Uri uri, int modeFlags)

向其他套件授予權限 (無論該套件是否具有存取 URI 內容供應器的一般權限)。

boolean isDeviceProtectedStorage()

指出此結構定義的儲存空間 API 是否由裝置保護儲存空間支援。

boolean isRestricted()

指出這個 Context 是否受限。

boolean moveDatabaseFrom(Context sourceContext, String name)

將現有資料庫檔案從指定的來源儲存空間內容移至這個內容。

boolean moveSharedPreferencesFrom(Context sourceContext, String name)

將現有的共用偏好設定檔案從指定的來源儲存空間結構定義移至這個結構定義。

FileInputStream openFileInput(String name)

開啟與這個 Context 應用程式套件相關聯的私人檔案,以供讀取。

FileOutputStream openFileOutput(String name, int mode)

開啟與這個 Context 應用程式套件相關聯的私人檔案進行寫入。

SQLiteDatabase openOrCreateDatabase(String name, int mode, SQLiteDatabase.CursorFactory factory, DatabaseErrorHandler errorHandler)

開啟與這個 Context 應用程式套件相關聯的新私人 SQLiteDatabase。

SQLiteDatabase openOrCreateDatabase(String name, int mode, SQLiteDatabase.CursorFactory factory)

開啟與這個 Context 應用程式套件相關聯的新私人 SQLiteDatabase。

Drawable peekWallpaper()

此方法已淘汰。 請改用 WallpaperManager.peek()

void registerComponentCallbacks(ComponentCallbacks callback)

將新的 ComponentCallbacks 新增至 Context 的基本應用程式,系統會在呼叫活動和其他元件的 ComponentCallbacks 方法時一併呼叫此 ComponentCallbacks

void registerDeviceIdChangeListener(Executor executor, IntConsumer listener)

將新的裝置 ID 已變更事件監聽器新增至 Context,當系統變更裝置關聯時,就會呼叫這個事件監聽器。

Intent registerReceiver(BroadcastReceiver receiver, IntentFilter filter)

註冊 BroadcastReceiver,以便在主活動執行緒中執行。

Intent registerReceiver(BroadcastReceiver receiver, IntentFilter filter, int flags)

註冊以接收意圖廣播,並視需要將接收器公開給即時應用程式。

Intent registerReceiver(BroadcastReceiver receiver, IntentFilter filter, String broadcastPermission, Handler scheduler, int flags)

註冊即可接收意圖廣播訊息,並在 scheduler 的環境中執行。

Intent registerReceiver(BroadcastReceiver receiver, IntentFilter filter, String broadcastPermission, Handler scheduler)

註冊接收意圖廣播,以便在 scheduler 的背景中執行。

void removeStickyBroadcast(Intent intent)

這個方法已淘汰。 請勿使用固定式廣播訊息。這些檔案沒有安全性 (任何人都可以存取)、沒有保護機制 (任何人都可以修改),而且還有許多其他問題。建議您使用非固定式廣播訊息,回報「某物」已變更,並搭配其他機制,讓應用程式視需要擷取目前的值。

void removeStickyBroadcastAsUser(Intent intent, UserHandle user)

這個方法已淘汰。 請勿使用固定式廣播訊息。這些檔案沒有安全性 (任何人都可以存取)、沒有保護機制 (任何人都可以修改),而且還有許多其他問題。建議您使用非固定式廣播訊息,回報「某物」已變更,並搭配其他機制,讓應用程式視需要擷取目前的值。

void revokeSelfPermissionsOnKill(Collection<String> permissions)

觸發對呼叫套件的一或多項權限撤銷作業。

void revokeUriPermission(Uri uri, int modeFlags)

移除先前透過 grantUriPermission(String, Uri, int) 或「任何其他」機制新增的權限,以便存取特定內容供應器 Uri。

void revokeUriPermission(String targetPackage, Uri uri, int modeFlags)

移除先前針對特定目標套件,使用 grantUriPermission(String, Uri, int) 新增的特定內容提供者 Uri 的存取權。

void sendBroadcast(Intent intent, String receiverPermission, Bundle options)

將指定的意圖廣播給所有感興趣的 BroadcastReceiver,讓可選的必要權限得以強制執行。

void sendBroadcast(Intent intent, String receiverPermission)

將指定的意圖廣播給所有感興趣的 BroadcastReceiver,讓可選的必要權限得以強制執行。

void sendBroadcast(Intent intent)

將指定的意圖廣播給所有感興趣的 BroadcastReceiver。

void sendBroadcastAsUser(Intent intent, UserHandle user)

可讓您指定要傳送廣播訊息的使用者。sendBroadcast(android.content.Intent)

void sendBroadcastAsUser(Intent intent, UserHandle user, String receiverPermission)

sendBroadcast(android.content.Intent, java.lang.String) 版本,可讓您指定要接收廣播訊息的使用者。

void sendOrderedBroadcast(Intent intent, String receiverPermission, String receiverAppOp, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)

可讓您指定 App Op 的 sendOrderedBroadcast(android.content.Intent, java.lang.String, android.content.BroadcastReceiver, android.os.Handler, int, java.lang.String, android.os.Bundle) 版本,以便針對廣播傳送至哪些接收器實施限制。

void sendOrderedBroadcast(Intent intent, int initialCode, String receiverPermission, String receiverAppOp, BroadcastReceiver resultReceiver, Handler scheduler, String initialData, Bundle initialExtras, Bundle options)

void sendOrderedBroadcast(Intent intent, String receiverPermission, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)

可讓您接收廣播回傳資料的 sendBroadcast(android.content.Intent) 版本。

void sendOrderedBroadcast(Intent intent, String receiverPermission, Bundle options)

將指定的意圖廣播給所有感興趣的 BroadcastReceiver,一次傳送一個,讓更多優先接收器先行使用廣播訊息,再傳送給較不優先的接收器。

void sendOrderedBroadcast(Intent intent, String receiverPermission, Bundle options, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)

可讓您接收廣播回傳資料的 sendBroadcast(android.content.Intent) 版本。

void sendOrderedBroadcast(Intent intent, String receiverPermission)

將指定的意圖廣播給所有感興趣的 BroadcastReceiver,一次傳送一個,讓更多優先接收器先行使用廣播訊息,再傳送給較不優先的接收器。

void sendOrderedBroadcastAsUser(Intent intent, UserHandle user, String receiverPermission, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)

sendOrderedBroadcast(android.content.Intent, java.lang.String, android.content.BroadcastReceiver, android.os.Handler, int, java.lang.String, android.os.Bundle) 的版本,可讓您指定要接收廣播訊息的使用者。

void sendStickyBroadcast(Intent intent)

這個方法已淘汰。 請勿使用固定式廣播訊息。這些檔案沒有安全性 (任何人都能存取)、沒有保護機制 (任何人都能修改),而且還有許多其他問題。建議您使用非固定式廣播訊息,回報「某物」已變更,並搭配其他機制,讓應用程式視需要擷取目前的值。

void sendStickyBroadcast(Intent intent, Bundle options)

這個方法已淘汰。 請勿使用固定式廣播訊息。並且沒有安全性 (任何人都能存取)、沒有防護 (任何人都能修改),以及許多其他的問題。 建議您使用非固定式廣播訊息,回報「某物」已變更,並搭配其他機制,讓應用程式視需要擷取目前的值。

void sendStickyBroadcastAsUser(Intent intent, UserHandle user)

這個方法已淘汰。 請勿使用固定式廣播訊息。並且沒有安全性 (任何人都能存取)、沒有防護 (任何人都能修改),以及許多其他的問題。 建議您使用非固定式廣播訊息,回報「某物」已變更,並搭配其他機制,讓應用程式視需要擷取目前的值。

void sendStickyOrderedBroadcast(Intent intent, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)

這個方法已淘汰。 請勿使用固定式廣播訊息。並且沒有安全性 (任何人都能存取)、沒有防護 (任何人都能修改),以及許多其他的問題。 建議您使用非固定式廣播訊息,回報「某物」已變更,並搭配其他機制,讓應用程式視需要擷取目前的值。

void sendStickyOrderedBroadcastAsUser(Intent intent, UserHandle user, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)

此方法已淘汰。 請勿使用固定式廣播訊息。並且沒有安全性 (任何人都能存取)、沒有防護 (任何人都能修改),以及許多其他的問題。 建議的模式是使用非固定式廣播訊息,回報某部分發生變更的情形,並讓應用程式視需要透過其他機制擷取目前的值。

void setTheme(int resid)

為這個內容設定基本主題。

void setWallpaper(Bitmap bitmap)

此方法已淘汰。 請改用 WallpaperManager.set()

這個方法需要呼叫端持有 Manifest.permission.SET_WALLPAPER 權限。

void setWallpaper(InputStream data)

此方法已淘汰。 請改用 WallpaperManager.set()

這個方法需要呼叫端持有 Manifest.permission.SET_WALLPAPER 權限。

void startActivities(Intent[] intents, Bundle options)

啟動多個新活動。

void startActivities(Intent[] intents)

與未指定任何選項的 startActivities(android.content.Intent[], android.os.Bundle) 相同。

void startActivity(Intent intent)

與未指定任何選項的 startActivity(android.content.Intent, android.os.Bundle) 相同。

void startActivity(Intent intent, Bundle options)

啟動新活動。

ComponentName startForegroundService(Intent service)

startService(android.content.Intent) 類似,但有隱含的承諾,指出服務會在開始執行時呼叫 startForeground(int, android.app.Notification)

boolean startInstrumentation(ComponentName className, String profileFile, Bundle arguments)

開始執行 Instrumentation 類別。

void startIntentSender(IntentSender intent, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags)

與未指定任何選項的 startIntentSender(android.content.IntentSender, android.content.Intent, int, int, int, android.os.Bundle) 相同。

void startIntentSender(IntentSender intent, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags, Bundle options)

startActivity(android.content.Intent, android.os.Bundle) 類似,但會使用 IntentSender 來啟動。

ComponentName startService(Intent service)

要求啟動特定應用程式服務。

boolean stopService(Intent name)

要求停止特定應用程式服務。

void unbindService(ServiceConnection conn)

中斷應用程式服務的連線。

void unregisterComponentCallbacks(ComponentCallbacks callback)

移除先前透過 registerComponentCallbacks(android.content.ComponentCallbacks) 註冊的 ComponentCallbacks 物件。

void unregisterDeviceIdChangeListener(IntConsumer listener)

從 Context 中移除裝置 ID 變更事件監聽器。

void unregisterReceiver(BroadcastReceiver receiver)

取消註冊先前註冊的 BroadcastReceiver。

void updateServiceGroup(ServiceConnection conn, int group, int importance)

如果服務先前已綁定 bindService(Intent, BindServiceFlags, Executor, ServiceConnection) 或相關方法,請變更系統管理該服務與其他程序相關的程序方式。

boolean bindIsolatedService(Intent service, int flags, String instanceName, Executor executor, ServiceConnection conn)

bindService(Intent, BindServiceFlags, Executor, ServiceConnection) 的變化版本,在 isolated services 的特定情況下,允許呼叫端從單一元件宣告產生多個服務例項。

boolean bindIsolatedService(Intent service, Context.BindServiceFlags flags, String instanceName, Executor executor, ServiceConnection conn)

請參閱 bindIsolatedService(android.content.Intent, int, java.lang.String, java.util.concurrent.Executor, android.content.ServiceConnection) 一文,瞭解如何呼叫 BindServiceFlags#of(long) 取得 BindServiceFlags 物件。

boolean bindService(Intent service, int flags, Executor executor, ServiceConnection conn)

bindService(Intent, ServiceConnection, int) 相同,但使用執行緒來控管 ServiceConnection 回呼。

boolean bindService(Intent service, ServiceConnection conn, Context.BindServiceFlags flags)

請參閱 bindService(android.content.Intent, android.content.ServiceConnection, int) 一節,瞭解如何呼叫 BindServiceFlags#of(long) 以取得 BindServiceFlags 物件。

abstract boolean bindService(Intent service, ServiceConnection conn, int flags)

連線至應用程式服務,並視需求建立。

boolean bindService(Intent service, Context.BindServiceFlags flags, Executor executor, ServiceConnection conn)

請參閱 bindService(android.content.Intent, int, java.util.concurrent.Executor, android.content.ServiceConnection) 一文,瞭解如何呼叫 BindServiceFlags#of(long) 取得 BindServiceFlags 物件。

boolean bindServiceAsUser(Intent service, ServiceConnection conn, int flags, UserHandle user)

採用與 bindService(Intent, BindServiceFlags, Executor, ServiceConnection) 相同的方式,繫結至指定 user 中的服務。

boolean bindServiceAsUser(Intent service, ServiceConnection conn, Context.BindServiceFlags flags, UserHandle user)

請參閱 bindServiceAsUser(android.content.Intent, android.content.ServiceConnection, int, android.os.UserHandle) 呼叫 BindServiceFlags#of(long) 以取得 BindServiceFlags 物件。

abstract int checkCallingOrSelfPermission(String permission)

判斷 IPC 的呼叫程序或您是否已獲得特定權限。

abstract int checkCallingOrSelfUriPermission(Uri uri, int modeFlags)

判斷 IPC 的呼叫程序 或您是否已獲得存取特定 URI 的權限。

int[] checkCallingOrSelfUriPermissions(List<Uri> uris, int modeFlags)

判斷 IPC 的呼叫程序 或您是否已獲得存取 URI 清單的權限。

abstract int checkCallingPermission(String permission)

判斷您正在處理的 IPC 呼叫程序是否已獲得特定權限。

abstract int checkCallingUriPermission(Uri uri, int modeFlags)

判斷呼叫程序和使用者 ID 是否已獲得存取特定 URI 的權限。

int[] checkCallingUriPermissions(List<Uri> uris, int modeFlags)

判斷是否已授予呼叫程序和使用者 ID 存取 URI 清單的權限。

abstract int checkPermission(String permission, int pid, int uid)

判斷是否允許特定權限適用於在系統中執行的特定程序和使用者 ID。

abstract int checkSelfPermission(String permission)

判斷系統是否已授予 特定權限。

abstract int checkUriPermission(Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags)

檢查 Uri 和一般權限。

abstract int checkUriPermission(Uri uri, int pid, int uid, int modeFlags)

判斷特定程序和使用者 ID 是否已獲得存取特定 URI 的權限。

int[] checkUriPermissions(List<Uri> uris, int pid, int uid, int modeFlags)

判斷特定程序和使用者 ID 是否已獲得存取 URI 清單的權限。

abstract void clearWallpaper()

API 級別 15 已淘汰此方法。請改用 WallpaperManager.clear()

此方法需要呼叫端擁有 Manifest.permission.SET_WALLPAPER 權限。

Context createAttributionContext(String attributionTag)

為目前的 Context 傳回新的 Context 物件,但將其歸屬於不同的標記。

abstract Context createConfigurationContext(Configuration overrideConfiguration)

針對目前情境傳回新的 Context 物件,但其資源會經過調整,以符合指定設定。

Context createContext(ContextParams contextParams)

建立具有特定屬性和行為的內容。

abstract Context createContextForSplit(String splitName)

傳回指定分割名稱的新 Context 物件。

Context createDeviceContext(int deviceId)

從目前的內容傳回新的 Context 物件,但會附帶 deviceId 提供的裝置關聯。

abstract Context createDeviceProtectedStorageContext()

為目前的 Context 傳回新的 Context 物件,但其儲存空間 API 由裝置保護儲存空間提供支援。

abstract Context createDisplayContext(Display display)

從目前的內容傳回新的 Context 物件,但資源會調整為符合 display 的指標。

abstract Context createPackageContext(String packageName, int flags)

傳回指定應用程式名稱的新 Context 物件。

Context createWindowContext(int type, Bundle options)

為非活動視窗建立內容。

Context createWindowContext(Display display, int type, Bundle options)

在指定的 Display 上,為非 activity 視窗建立 Context

abstract String[] databaseList()

傳回字串陣列,命名與這個 Context 應用程式套件相關聯的私人資料庫。

abstract boolean deleteDatabase(String name)

刪除與這個 Context 應用程式套件相關聯的現有私人 SQLiteDatabase。

abstract boolean deleteFile(String name)

刪除與這個情境應用程式套件相關聯的指定私人檔案。

abstract boolean deleteSharedPreferences(String name)

刪除現有的共用偏好設定檔案。

abstract void enforceCallingOrSelfPermission(String permission, String message)

如果您或您所處理的 IPC 呼叫程序未獲得特定權限,請擲回 SecurityException

abstract void enforceCallingOrSelfUriPermission(Uri uri, int modeFlags, String message)

如果 IPC 的呼叫程序 或您未獲得存取特定 URI 的權限,請擲回 SecurityException

abstract void enforceCallingPermission(String permission, String message)

如果您處理的處理序間通訊 (IPC) 呼叫程序尚未獲得特定權限,請擲回 SecurityException

abstract void enforceCallingUriPermission(Uri uri, int modeFlags, String message)

若呼叫程序和使用者 ID 尚未獲得存取特定 URI 的權限,請擲回 SecurityException

abstract void enforcePermission(String permission, int pid, int uid, String message)

如果授予特定權限給在系統中運作的特定程序和使用者 ID,則擲回 SecurityException

abstract void enforceUriPermission(Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags, String message)

同時強制執行 URI 和一般權限。

abstract void enforceUriPermission(Uri uri, int pid, int uid, int modeFlags, String message)

如果特定程序和使用者 ID 未獲得存取特定 URI 的權限,請擲回 SecurityException

abstract String[] fileList()

傳回字串陣列,命名與此 Context 應用程式套件相關聯的私人檔案。

abstract Context getApplicationContext()

傳回目前程序的單一全域 Application 物件內容。

abstract ApplicationInfo getApplicationInfo()

傳回這個結構定義套件的完整應用程式資訊。

abstract AssetManager getAssets()

傳回應用程式套件的 AssetManager 執行個體。

AttributionSource getAttributionSource()
String getAttributionTag()

歸因可用於複雜的應用程式,用於邏輯上分隔應用程式的部分。

abstract File getCacheDir()

傳回檔案系統中應用程式專屬快取目錄的絕對路徑。

abstract ClassLoader getClassLoader()

傳回可用於擷取此套件中類別的類別載入器。

abstract File getCodeCacheDir()

傳回專為儲存快取程式碼而設計之檔案系統中,應用程式特定快取目錄的絕對路徑。

final int getColor(int id)

傳回與特定資源 ID 相關聯的顏色,且符合目前主題的樣式。

final ColorStateList getColorStateList(int id)

傳回與特定資源 ID 相關聯,且符合目前主題樣式的色彩狀態清單。

abstract ContentResolver getContentResolver()

傳回應用程式套件的 ContentResolver 例項。

abstract File getDataDir()

傳回檔案系統中目錄的絕對路徑,此目錄儲存所有屬於此應用程式的私人檔案。

abstract File getDatabasePath(String name)

傳回使用 openOrCreateDatabase(String, int, CursorFactory) 建立的資料庫儲存檔案系統的絕對路徑。

int getDeviceId()

取得此情境所關聯的裝置 ID。

abstract File getDir(String name, int mode)

擷取 (視需要建立) 新的目錄,讓應用程式可將自訂資料檔案放入其中。

Display getDisplay()

取得與此內容相關聯的顯示畫面。

final Drawable getDrawable(int id)

傳回與特定資源 ID 相關聯的 drawable 物件,並為目前主題設定樣式。

abstract File getExternalCacheDir()

傳回主要共用/外部儲存裝置中應用程式特定目錄的絕對路徑,讓應用程式可在其中放置自己的快取檔案。

abstract File[] getExternalCacheDirs()

傳回所有共用/外部儲存裝置中應用程式專屬目錄的絕對路徑,應用程式可在該目錄中放置所擁有的快取檔案。

abstract File getExternalFilesDir(String type)

傳回主要共用/外部儲存裝置中目錄的絕對路徑,讓應用程式可在其中放置自有的永久檔案。

abstract File[] getExternalFilesDirs(String type)

傳回所有共用/外部儲存裝置中應用程式專屬目錄的絕對路徑,應用程式可在此放置其擁有的永久檔案。

abstract File[] getExternalMediaDirs()

API 級別 30 已淘汰此方法。這些目錄仍會存在並進行掃描,但我們建議開發人員改為直接將內容插入 MediaStore 集合,因為從 Build.VERSION_CODES.Q 開始,任何應用程式都可以將新媒體貢獻給 MediaStore,且無需權限。

abstract File getFileStreamPath(String name)

傳回檔案系統中的絕對路徑,其中儲存了使用 openFileOutput(String, int) 建立的檔案。

abstract File getFilesDir()

傳回儲存使用 openFileOutput(String, int) 建立的檔案系統目錄的絕對路徑。

Executor getMainExecutor()

傳回 Executor,以便在與這個結構定義相關聯的主執行緒上執行已加入佇列的工作。

abstract Looper getMainLooper()

針對目前程序的主執行緒傳回迴圈。

abstract File getNoBackupFilesDir()

傳回檔案系統中目錄的絕對路徑,類似 getFilesDir()

abstract File getObbDir()

傳回主要共用/外部儲存空間目錄,可在此目錄中找到此應用程式的 OBB 檔案 (如有)。

abstract File[] getObbDirs()

傳回所有共用/外部儲存裝置中應用程式專屬目錄的絕對路徑,可用於尋找應用程式的 OBB 檔案 (如有)。

String getOpPackageName()

從這個情境中傳回應當用於 AppOpsManager 呼叫的套件名稱,以便應用程式作業管理員的 uid 驗證可搭配該名稱運作。

abstract String getPackageCodePath()

傳回此結構定義主要 Android 套件的完整路徑。

abstract PackageManager getPackageManager()

傳回 PackageManager 例項,以便查找全域套件資訊。

abstract String getPackageName()

傳回此應用程式套件的名稱。

abstract String getPackageResourcePath()

傳回此內容的主要 Android 套件的完整路徑。

ContextParams getParams()

如果此 Context 是透過 createContext(android.content.ContextParams) 建立,則傳回用於建立該 Context 的參數集。

abstract Resources getResources()

傳回應用程式套件的 Resources 例項。

abstract SharedPreferences getSharedPreferences(String name, int mode)

擷取並保留偏好設定檔「name」的內容,傳回 SharedPreferences,您可以透過該值擷取及修改其值。

final String getString(int resId)

傳回應用程式套件的預設字串表中的本地化字串。

final String getString(int resId, Object... formatArgs)

從應用程式套件的預設字串表格傳回已本地化的格式化字串,並替換 FormatterString.format(String, Object) 中定義的格式引數。

final <T> T getSystemService(Class<T> serviceClass)

按照類別將控制代碼傳回系統層級的服務。

abstract Object getSystemService(String name)

依名稱將控制代碼傳回系統層級的服務。

abstract String getSystemServiceName(Class<?> serviceClass)

取得由指定類別代表的系統層級服務名稱。

final CharSequence getText(int resId)

從應用程式套件的預設字串表格傳回經過本地化的樣式化 CharSequence。

abstract Resources.Theme getTheme()

傳回與此 Context 相關聯的 Theme 物件。

abstract Drawable getWallpaper()

API 級別 15 已淘汰此方法。請改用 WallpaperManager.get()

abstract int getWallpaperDesiredMinimumHeight()

API 級別 15 已淘汰此方法。請改用 WallpaperManager.getDesiredMinimumHeight()

abstract int getWallpaperDesiredMinimumWidth()

API 級別 15 已淘汰此方法。請改用 WallpaperManager.getDesiredMinimumWidth()

abstract void grantUriPermission(String toPackage, Uri uri, int modeFlags)

無論其他套件是否有權存取 URI 的內容供應器,皆可授予存取特定 URI 的權限。

abstract boolean isDeviceProtectedStorage()

指出此結構定義的儲存空間 API 是否由裝置保護儲存空間支援。

boolean isRestricted()

指出這個 Context 是否受限。

boolean isUiContext()

如果結構定義是可存取 WindowManagerLayoutInflaterWallpaperManager 等 UI 元件的 UI 內容,則傳回 true

abstract boolean moveDatabaseFrom(Context sourceContext, String name)

將現有資料庫檔案從指定的來源儲存空間內容移至這個內容。

abstract boolean moveSharedPreferencesFrom(Context sourceContext, String name)

將現有的共用偏好設定檔案從指定的來源儲存空間情境移至這個情境。

final TypedArray obtainStyledAttributes(AttributeSet set, int[] attrs)

擷取這個 Context 主題中的樣式屬性資訊。

final TypedArray obtainStyledAttributes(AttributeSet set, int[] attrs, int defStyleAttr, int defStyleRes)

擷取這個 Context 主題中的樣式屬性資訊。

final TypedArray obtainStyledAttributes(int resid, int[] attrs)

擷取這個 Context 主題中的樣式屬性資訊。

final TypedArray obtainStyledAttributes(int[] attrs)

擷取此情境主題中的樣式化屬性資訊。

abstract FileInputStream openFileInput(String name)

開啟與這個 Context 應用程式套件相關聯的私人檔案,進行讀取。

abstract FileOutputStream openFileOutput(String name, int mode)

開啟與這個 Context 應用程式套件相關聯的私人檔案進行寫入。

abstract SQLiteDatabase openOrCreateDatabase(String name, int mode, SQLiteDatabase.CursorFactory factory, DatabaseErrorHandler errorHandler)

開啟與這個 Context 應用程式套件相關聯的新私人 SQLiteDatabase。

abstract SQLiteDatabase openOrCreateDatabase(String name, int mode, SQLiteDatabase.CursorFactory factory)

開啟與這個 Context 應用程式套件相關聯的新私人 SQLiteDatabase。

abstract Drawable peekWallpaper()

這個方法已在 API 級別 15 中淘汰。 請改用 WallpaperManager.peek()

void registerComponentCallbacks(ComponentCallbacks callback)

將新的 ComponentCallbacks 新增至 Context 的基礎應用程式,系統會在呼叫活動和其他元件的 ComponentCallbacks 方法時,呼叫該程式。

void registerDeviceIdChangeListener(Executor executor, IntConsumer listener)

將新的裝置 ID 變更事件監聽器新增至 Context,系統變更裝置關聯時,系統會呼叫該監聽器。

abstract Intent registerReceiver(BroadcastReceiver receiver, IntentFilter filter)

註冊 BroadcastReceiver,以便在主活動執行緒中執行。

abstract Intent registerReceiver(BroadcastReceiver receiver, IntentFilter filter, int flags)

註冊以接收意圖廣播,並視需要將接收器公開給即時應用程式。

abstract Intent registerReceiver(BroadcastReceiver receiver, IntentFilter filter, String broadcastPermission, Handler scheduler, int flags)

註冊即可接收意圖廣播訊息,並在 scheduler 的環境中執行。

abstract Intent registerReceiver(BroadcastReceiver receiver, IntentFilter filter, String broadcastPermission, Handler scheduler)

註冊即可接收意圖廣播訊息,並在 scheduler 的環境中執行。

abstract void removeStickyBroadcast(Intent intent)

API 級別 21 已淘汰此方法。請勿使用固定式廣播訊息。這些檔案沒有安全性 (任何人都可以存取)、沒有保護機制 (任何人都可以修改),而且還有許多其他問題。建議您使用非固定式廣播訊息,回報「某物」已變更,並搭配其他機制,讓應用程式視需要擷取目前的值。

abstract void removeStickyBroadcastAsUser(Intent intent, UserHandle user)

API 級別 21 已淘汰此方法。請勿使用固定式廣播訊息。這些檔案沒有安全性 (任何人都能存取)、沒有保護機制 (任何人都能修改),而且還有許多其他問題。建議您使用非固定式廣播訊息,回報「某物」已變更,並搭配其他機制,讓應用程式視需要擷取目前的值。

void revokeSelfPermissionOnKill(String permName)

觸發執行階段權限的非同步撤銷作業。

void revokeSelfPermissionsOnKill(Collection<String> permissions)

觸發呼叫套件的一或多項權限。

abstract void revokeUriPermission(Uri uri, int modeFlags)

移除先前透過 grantUriPermission(String, Uri, int) 或「任何其他」機制新增的權限,以便存取特定內容供應器 Uri。

abstract void revokeUriPermission(String toPackage, Uri uri, int modeFlags)

移除先前針對特定目標套件,使用 grantUriPermission(String, Uri, int) 新增的特定內容提供者 Uri 的存取權。

void sendBroadcast(Intent intent, String receiverPermission, Bundle options)

將指定的意圖廣播給所有感興趣的 BroadcastReceiver,讓可選的必要權限得以強制執行。

abstract void sendBroadcast(Intent intent, String receiverPermission)

將指定的意圖廣播給所有感興趣的 BroadcastReceiver,讓可選的必要權限得以強制執行。

abstract void sendBroadcast(Intent intent)

將指定意圖廣播給所有感興趣的 BroadcastReceiver。

abstract void sendBroadcastAsUser(Intent intent, UserHandle user)

可讓您指定要傳送廣播訊息的使用者。sendBroadcast(android.content.Intent)

abstract void sendBroadcastAsUser(Intent intent, UserHandle user, String receiverPermission)

可讓您指定要傳送廣播訊息的使用者。sendBroadcast(android.content.Intent, java.lang.String)

void sendBroadcastWithMultiplePermissions(Intent intent, String[] receiverPermissions)

將指定的意圖廣播給所有感興趣的 BroadcastReceiver,以便強制執行一系列必要權限。

void sendOrderedBroadcast(Intent intent, String receiverPermission, String receiverAppOp, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)

sendOrderedBroadcast(android.content.Intent, java.lang.String, android.content.BroadcastReceiver, android.os.Handler, int, java.lang.String, android.os.Bundle) 的版本,可讓您指定應用程式運算能力,強制限制廣播訊息的目標接收器。

abstract void sendOrderedBroadcast(Intent intent, String receiverPermission, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)

可讓您接收來自廣播的資料的 sendBroadcast(android.content.Intent) 版本。

void sendOrderedBroadcast(Intent intent, String receiverPermission, Bundle options)

將指定的意圖廣播給所有感興趣的 BroadcastReceiver,一次傳送一個,讓更多優先接收器先行使用廣播訊息,再傳送給較不優先的接收器。

void sendOrderedBroadcast(Intent intent, String receiverPermission, Bundle options, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)

可讓您接收廣播回傳資料的 sendBroadcast(android.content.Intent) 版本。

abstract void sendOrderedBroadcast(Intent intent, String receiverPermission)

將指定意圖廣播給所有感興趣的 BroadcastReceiver,逐一傳送,讓更多偏好接收器先行使用廣播訊息,再傳送給較不偏好的接收器。

abstract void sendOrderedBroadcastAsUser(Intent intent, UserHandle user, String receiverPermission, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)

sendOrderedBroadcast(android.content.Intent, java.lang.String, android.content.BroadcastReceiver, android.os.Handler, int, java.lang.String, android.os.Bundle) 的版本,可讓您指定要接收廣播訊息的使用者。

abstract void sendStickyBroadcast(Intent intent)

API 級別 21 已淘汰此方法。請勿使用固定式廣播訊息。這些檔案沒有安全性 (任何人都能存取)、沒有保護機制 (任何人都能修改),而且還有許多其他問題。建議您使用非固定式廣播訊息,回報「某物」已變更,並搭配其他機制,讓應用程式視需要擷取目前的值。

void sendStickyBroadcast(Intent intent, Bundle options)

這個方法已在 API 級別 31 中淘汰。 請勿使用固定式廣播訊息。並且沒有安全性 (任何人都能存取)、沒有防護 (任何人都能修改),以及許多其他的問題。 建議您使用非固定式廣播訊息,回報「某物」已變更,並搭配其他機制,讓應用程式視需要擷取目前的值。

abstract void sendStickyBroadcastAsUser(Intent intent, UserHandle user)

此方法已在 API 級別 21 中淘汰。請勿使用固定式廣播訊息。並且沒有安全性 (任何人都能存取)、沒有防護 (任何人都能修改),以及許多其他的問題。 建議您使用非固定式廣播訊息,回報「某物」已變更,並搭配其他機制,讓應用程式視需要擷取目前的值。

abstract void sendStickyOrderedBroadcast(Intent intent, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)

此方法已在 API 級別 21 中淘汰。請勿使用固定式廣播訊息。並且沒有安全性 (任何人都能存取)、沒有防護 (任何人都能修改),以及許多其他的問題。 建議您使用非固定式廣播訊息,回報「某物」已變更,並搭配其他機制,讓應用程式視需要擷取目前的值。

abstract void sendStickyOrderedBroadcastAsUser(Intent intent, UserHandle user, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)

API 級別 21 已淘汰此方法。請勿使用固定式廣播訊息。這些檔案沒有安全性 (任何人都能存取)、沒有保護機制 (任何人都能修改),而且還有許多其他問題。建議您使用非固定式廣播訊息,回報「某物」已變更,並搭配其他機制,讓應用程式視需要擷取目前的值。

abstract void setTheme(int resid)

為這個內容設定基本主題。

abstract void setWallpaper(Bitmap bitmap)

API 級別 15 已淘汰此方法。請改用 WallpaperManager.set()

這個方法需要呼叫端持有 Manifest.permission.SET_WALLPAPER 權限。

abstract void setWallpaper(InputStream data)

API 級別 15 已淘汰此方法。請改用 WallpaperManager.set()

這個方法需要呼叫端持有 Manifest.permission.SET_WALLPAPER 權限。

abstract void startActivities(Intent[] intents, Bundle options)

啟動多個新活動。

abstract void startActivities(Intent[] intents)

startActivities(android.content.Intent[], android.os.Bundle) 相同,且未指定選項。

abstract void startActivity(Intent intent)

startActivity(android.content.Intent, android.os.Bundle) 相同,且未指定選項。

abstract void startActivity(Intent intent, Bundle options)

啟動新活動。

abstract ComponentName startForegroundService(Intent service)

startService(android.content.Intent) 類似,但有隱含的承諾,指出服務會在開始執行時呼叫 startForeground(int, android.app.Notification)

abstract boolean startInstrumentation(ComponentName className, String profileFile, Bundle arguments)

開始執行 Instrumentation 類別。

abstract void startIntentSender(IntentSender intent, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags)

與未指定任何選項的 startIntentSender(android.content.IntentSender, android.content.Intent, int, int, int, android.os.Bundle) 相同。

abstract void startIntentSender(IntentSender intent, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags, Bundle options)

startActivity(android.content.Intent, android.os.Bundle) 類似,但會使用 IntentSender 來啟動。

abstract ComponentName startService(Intent service)

要求啟動特定應用程式服務。

abstract boolean stopService(Intent service)

要求停止特定應用程式服務。

abstract void unbindService(ServiceConnection conn)

中斷與應用程式服務的連線。

void unregisterComponentCallbacks(ComponentCallbacks callback)

移除先前已向 registerComponentCallbacks(android.content.ComponentCallbacks) 註冊的 ComponentCallbacks 物件。

void unregisterDeviceIdChangeListener(IntConsumer listener)

從 Context 中移除裝置 ID 變更事件監聽器。

abstract void unregisterReceiver(BroadcastReceiver receiver)

取消註冊先前註冊的 BroadcastReceiver。

void updateServiceGroup(ServiceConnection conn, int group, int importance)

如果服務先前已綁定 bindService(Intent, BindServiceFlags, Executor, ServiceConnection) 或相關方法,請變更系統管理該服務與其他程序相關的程序方式。

Object clone()

建立並傳回此物件的副本。

boolean equals(Object obj)

指出是否有其他物件「等於」這個物件。

void finalize()

當垃圾收集判定物件沒有其他參照,垃圾收集器會針對該物件呼叫。

final Class<?> getClass()

傳回此 Object 的執行階段類別。

int hashCode()

傳回該物件的雜湊碼值。

final void notify()

喚醒單個等待此物件監控器的執行緒。

final void notifyAll()

喚醒所有等待此物件監控器的執行緒。

String toString()

傳回該物件的字串表示法。

final void wait(long timeoutMillis, int nanos)

讓目前的執行緒等待,直到遭到喚醒或經過一定的實際時間長度為止。喚醒方式通常是收到「通知」或遭到「中斷」

final void wait(long timeoutMillis)

讓目前的執行緒等待,直到遭到喚醒或經過一定的實際時間長度為止。喚醒方式通常是收到「通知」或遭到「中斷」

final void wait()

讓目前的執行緒等待,直到遭到喚醒為止。喚醒方式通常是收到「通知」或遭到「中斷」

abstract void onTrimMemory(int level)

當作業系統判斷程序適合從其程序中裁減不必要的記憶體時,系統會呼叫這個方法。

abstract void onConfigurationChanged(Configuration newConfig)

當元件執行期間裝置設定有所變更時,系統會呼叫此方法。

abstract void onLowMemory()

當整體系統的記憶體用量偏低時,系統會呼叫此方法,並且正在執行的程序應減少記憶體用量。

公用建構函式

IsolatedService

public IsolatedService ()

公用方法

getEventUrlProvider

public final EventUrlProvider getEventUrlProvider (RequestToken requestToken)

針對目前的要求傳回 EventUrlProviderEventUrlProvider 會提供可嵌入 HTML 中的網址。當 HTML 在 WebView 中轉譯時,平台會攔截傳送至這些網址的要求,並叫用 IsolatedWorker#onEvent(EventInput, Consumer)

參數
requestToken RequestToken:不透明權杖,可識別目前對服務的要求。此值不能為 null

傳回
EventUrlProvider 會傳回事件追蹤網址的 EventUrlProvider。此值不能為 null

另請參閱:

getFederatedComputeScheduler

public final FederatedComputeScheduler getFederatedComputeScheduler (RequestToken requestToken)

針對目前的要求傳回 FederatedComputeSchedulerFederatedComputeScheduler 可用於排定及取消聯合運算工作。聯合運算包括聯合學習和聯合分析工作。

參數
requestToken RequestToken:不透明權杖,可識別目前對服務的要求。此值不能為 null

傳回
FederatedComputeScheduler 傳回聯合運算工作排程器的 FederatedComputeScheduler。此值不能為 null

另請參閱:

getLocalData

public final MutableKeyValueStore getLocalData (RequestToken requestToken)

傳回 LOCAL_DATA 資料表的資料存取物件。LOCAL_DATA 資料表是服務可用來儲存任何資料的永久鍵/值儲存庫。這個表格的內容只會顯示在執行在隔離程序中的服務中,無法傳送至裝置外。

參數
requestToken RequestToken:不透明權杖,可識別目前對服務的要求。此值不能為 null

傳回
MutableKeyValueStore 提供 LOCAL_DATA 資料表存取權的 MutableKeyValueStore 物件。傳回的 MutableKeyValueStore 中的方法是封鎖作業,應從背景工作執行緒呼叫,而非主執行緒或 Binder 執行緒。此值不能為 null

另請參閱:

getLogReader

public final LogReader getLogReader (RequestToken requestToken)

針對 REQUESTS 和 EVENTS 資料表傳回 DAO,該資料表提供了 IsolatedService 可讀取的資料列存取權。

參數
requestToken RequestToken:不透明權杖,可識別目前對服務的要求。此值不能為 null

傳回
LogReader 提供 REQUESTS 和 EVENTS 資料表存取權的 LogReader 物件。 傳回的 LogReader 中的方法屬於阻斷作業,應從背景工作執行緒呼叫,而不是主執行緒或繫結器執行緒。此值不能為 null

另請參閱:

getRemoteData

public final KeyValueStore getRemoteData (RequestToken requestToken)

傳回 REMOTE_DATA 資料表的資料存取物件。REMOTE_DATA 資料表是唯讀鍵/值儲存庫,包含定期從 在服務的 ODP 資訊清單標記中宣告的端點下載的資料,如以下範例所示。

<!-- Contents of res/xml/OdpSettings.xml -->
 <on-device-personalization>
 <!-- Name of the service subclass -->
 <service "com.example.odpsample.SampleService">
   <!-- If this tag is present, ODP will periodically poll this URL and
    download content to populate REMOTE_DATA. Adopters that do not need to
    download content from their servers can skip this tag. -->
   <download-settings url="https://example.com/get" />
 </service>
 </on-device-personalization>
 

參數
requestToken RequestToken:不透明權杖,可識別目前對服務的要求。此值不能為 null

傳回
KeyValueStore 提供 REMOTE_DATA 資料表存取權的 KeyValueStore 物件。傳回的 KeyValueStore 中的各個方法都是封鎖作業,應從背景工作執行緒呼叫,而非主執行緒或 Binder 執行緒。此值不能為 null

另請參閱:

取得使用者資料

public final UserData getUserData (RequestToken requestToken)

傳回目前要求的平台提供的 UserData

參數
requestToken RequestToken:不透明權杖,可識別目前對服務的要求。此值不能為 null

傳回
UserData UserData 物件。值可以是 null

另請參閱:

onBind

public IBinder onBind (Intent intent)

處理與 IsolatedService 的繫結。

參數
intent Intent:用來繫結至這項服務的意圖,如給 Context.bindService 的指定。請注意,此時意圖中包含的任何額外項目「不會」顯示在此處。此值不能為 null

傳回
IBinder 這個值可以是 null

onCreate

public void onCreate ()

IsolatedService 建立繫結器。

onRequest

public abstract IsolatedWorker onRequest (RequestToken requestToken)

傳回處理用戶端要求的 IsolatedWorker 例項。

參數
requestToken RequestToken:這是不透明權杖,可識別目前對服務的要求,必須傳遞給依附於個別要求狀態的服務方法。此值不能為 null

傳回
IsolatedWorker 此值不能為 null