Context.GetSystemService 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| GetSystemService(Class) |
依類別將句柄回傳至系統層級服務。 |
| GetSystemService(String) |
以名稱將句柄回傳給系統層級服務。 |
GetSystemService(Class)
依類別將句柄回傳至系統層級服務。
[Android.Runtime.Register("getSystemService", "(Ljava/lang/Class;)Ljava/lang/Object;", "", ApiSince=23)]
[Java.Interop.JavaTypeParameters(new System.String[] { "T" })]
public Java.Lang.Object? GetSystemService(Java.Lang.Class serviceClass);
[<Android.Runtime.Register("getSystemService", "(Ljava/lang/Class;)Ljava/lang/Object;", "", ApiSince=23)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "T" })>]
member this.GetSystemService : Java.Lang.Class -> Java.Lang.Object
參數
- serviceClass
- Class
所期望服務的等級。
傳回
服務或 null 類別是否支援系統服務。 注意:如果名稱不被支援, 切勿 拋出 a RuntimeException 。
- 屬性
備註
依類別將句柄回傳至系統層級服務。
目前可用的職業包括:android.view.WindowManager, android.view.LayoutInflater, 。 android.app.ActivityManagerandroid.os.PowerManagerandroid.app.AlarmManagerandroid.app.NotificationManagerandroid.app.KeyguardManagerandroid.location.LocationManagerandroid.app.SearchManagerandroid.os.Vibratorandroid.net.ConnectivityManagerandroid.net.wifi.WifiManagerandroid.media.AudioManagerandroid.media.MediaRouterandroid.telephony.TelephonyManagerandroid.telephony.SubscriptionManagerandroid.view.inputmethod.InputMethodManagerandroid.app.UiModeManagerandroid.app.DownloadManagerandroid.os.BatteryManagerandroid.app.job.JobSchedulerandroid.app.usage.NetworkStatsManagerandroid.content.pm.verify.domain.DomainVerificationManagerandroid.view.displayhash.DisplayHashManagerandroid.security.authenticationpolicy.AuthenticationPolicyManager
注意:透過此 API 獲得的系統服務可能與其來源的上下文密切相關聯。 一般而言,不要在不同情境(活動、應用程式、服務、提供者等)間共享服務物件。
注意:即時應用程式PackageManager#isInstantApp()(回傳為 true)無法使用以下系統服務:#DEVICE_POLICY_SERVICE、#FINGERPRINT_SERVICE、#KEYGUARD_SERVICE、。 #SHORTCUT_SERVICE#USB_SERVICE#WALLPAPER_SERVICE#WIFI_P2P_SERVICE#WIFI_SERVICE#WIFI_AWARE_SERVICE 對於這些服務,此方法將返回 null。 一般來說,如果你是以即時應用程式執行,應該總是檢查此方法的結果是否為 null。
Java 文件 android.content.Context.getSystemService(java.lang.Class<T>)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。
適用於
GetSystemService(String)
以名稱將句柄回傳給系統層級服務。
[Android.Runtime.Register("getSystemService", "(Ljava/lang/String;)Ljava/lang/Object;", "GetGetSystemService_Ljava_lang_String_Handler")]
public abstract Java.Lang.Object? GetSystemService(string name);
[<Android.Runtime.Register("getSystemService", "(Ljava/lang/String;)Ljava/lang/Object;", "GetGetSystemService_Ljava_lang_String_Handler")>]
abstract member GetSystemService : string -> Java.Lang.Object
參數
- name
- String
想要服務的名稱。
傳回
服務名稱 null 或名稱不存在。
- 屬性
備註
以名稱將句柄回傳給系統層級服務。 回傳物件的類別會依請求名稱而異。 目前可用的名稱有:
<dl><dt>#WINDOW_SERVICE (「視窗」) <dd> 頂層視窗管理器,您可以在其中放置自訂視窗。 回傳的物件為 android.view.WindowManager。 必須僅從視覺情境(如活動)或以 #createWindowContext(int, Bundle)創建的情境中取得,這些情境會根據螢幕上區域的配置與視覺範圍進行調整。
<dt>#LAYOUT_INFLATER_SERVICE (「layout_inflater」) <dd> A android.view.LayoutInflater ,用於在此情境下膨脹版面資源。 必須僅從視覺情境(如活動)或以 #createWindowContext(int, Bundle)創建的情境中取得,這些情境會根據螢幕上區域的配置與視覺範圍進行調整。
<dt>#ACTIVITY_SERVICE (「活動」) <dd> A android.app.ActivityManager ,用於與系統的全域活動狀態互動。
<
>
#WALLPAPER_SERVICE dt(「壁紙」)<dd> Aandroid.service.wallpaper.WallpaperService,用於在此情境下存取桌布。 必須僅從視覺情境(如活動)或以 #createWindowContext(int, Bundle)創建的情境中取得,這些情境會根據螢幕上區域的配置與視覺範圍進行調整。
<dt>#POWER_SERVICE (「電源」) <dd> A android.os.PowerManager ,用於控制電源管理。
<dt>#ALARM_SERVICE (「警報」) <dd> A android.app.AlarmManager ,表示在你選擇的時間接收意圖。
<dt>#NOTIFICATION_SERVICE (「通知」) <dd> A android.app.NotificationManager ,用以通知使用者背景事件。
<dt>#KEYGUARD_SERVICE (「Keyguard」) <dd> A android.app.KeyguardManager ,代表控制 Keyguard。
<dt>#LOCATION_SERVICE (「位置」) <dd> A android.location.LocationManager 用於控制位置(例如GPS)更新。
<dt>#SEARCH_SERVICE (「搜尋」) <dd> A android.app.SearchManager ,用於處理搜尋。
<dt>#VIBRATOR_MANAGER_SERVICE (「vibrator_manager」) <dd> A android.os.VibratorManager ,用於存取裝置振動器、與單一振動器互動,並在多個振動器上同步播放效果。
<dt>#VIBRATOR_SERVICE (「震動器」) <dd> A android.os.Vibrator ,用於與震動器硬體互動。
<dt>#CONNECTIVITY_SERVICE (「連接性」) <dd> A android.net.ConnectivityManager ConnectivityManager ,用於處理網路連線管理。
<dt>#IPSEC_SERVICE (「ipsec」) <dd> A android.net.IpSecManager IpSecManager ,用於在套接字與網路上管理IPSec。
<dt>#WIFI_SERVICE (「WiFi」) <dd> A android.net.wifi.WifiManager WifiManager 用於管理 Wi-Fi 連線。 在 Android 7 之前的版本中,應僅從應用程式上下文取得,且不應從其他衍生上下文取得,以避免呼叫程序內的記憶體洩漏。
<dt>#WIFI_AWARE_SERVICE (「wifiaware」) <dd> A android.net.wifi.aware.WifiAwareManager WifiAwareManager ,用於管理 Wi-Fi Aware的發現與連線。
<dt>#WIFI_P2P_SERVICE (「wifip2p」) <dd> A android.net.wifi.p2p.WifiP2pManager WifiP2pManager 用於管理 Wi-Fi 直接連線。
<dt>#INPUT_METHOD_SERVICE (「input_method」) <dd> An android.view.inputmethod.InputMethodManager InputMethodManager 用於輸入方法管理。
<dt>#UI_MODE_SERVICE (「uimode」) <dd> 用於 android.app.UiModeManager 控制 UI 模式。
<dt>(「下載」)dd <> Aandroid.app.DownloadManager(請求HTTP下載)、<dt>#BATTERY_SERVICE(「電池管理器」)<dd> Aandroid.os.BatteryManager(管理電池狀態<)、dt#JOB_SCHEDULER_SERVICE>(「工作管理員」)<dd Aandroid.app.job.JobScheduler(管理排程任務<)、dt>>#NETWORK_STATS_SERVICE(「netstats」) <> dd Aandroid.app.usage.NetworkStatsManager NetworkStatsManager(查詢網路使用統計)。#DOWNLOAD_SERVICE
<dt>#HARDWARE_PROPERTIES_SERVICE (「hardware_properties」) <dd> A android.os.HardwarePropertiesManager ,用於存取硬體屬性。
<dt>#DOMAIN_VERIFICATION_SERVICE (「domain_verification」) <dd> A android.content.pm.verify.domain.DomainVerificationManager ,用於存取網域核准狀態。
<dt>#DISPLAY_HASH_SERVICE (「display_hash」) <dd> A android.view.displayhash.DisplayHashManager 用於管理顯示雜湊值。
<dt>#AUTHENTICATION_POLICY_SERVICE (「authentication_policy」) <dd> A android.security.authenticationpolicy.AuthenticationPolicyManager ,用於管理裝置上的驗證相關政策。
</dl>
注意:透過此 API 獲得的系統服務可能與其來源的上下文密切相關聯。 一般而言,不要在不同情境(活動、應用程式、服務、提供者等)間共享服務物件。
注意:即時應用程式PackageManager#isInstantApp()(回傳為 true)無法使用以下系統服務:#DEVICE_POLICY_SERVICE、#FINGERPRINT_SERVICE、#KEYGUARD_SERVICE、。 #SHORTCUT_SERVICE#USB_SERVICE#WALLPAPER_SERVICE#WIFI_P2P_SERVICE#WIFI_SERVICE#WIFI_AWARE_SERVICE 對於這些服務,此方法將返回 null。 一般來說,如果你是以即時應用程式執行,應該總是檢查此方法的結果是否為 null。
注意:實作此方法時,請記得新版 Android 可能會新增服務,所以如果你只想找上述明確名稱,記得在不認識名稱和 mdash 時回傳 null ;若拋出 RuntimeException 例外,應用程式可能會在新版 Android 版本中出問題。
Java 文件 android.content.Context.getSystemService(java.lang.String)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。
另請參閱
- WindowService
- IWindowManager
- LayoutInflaterService
- LayoutInflater
- ActivityService
- ActivityManager
- PowerService
- PowerManager
- AlarmService
- AlarmManager
- NotificationService
- NotificationManager
- KeyguardService
- KeyguardManager
- LocationService
- LocationManager
- SearchService
- SearchManager
- SensorService
- SensorManager
- StorageService
- StorageManager
- VibratorService
- Vibrator
- ConnectivityService
- ConnectivityManager
- WifiService
- WifiManager
- AudioService
- AudioManager
- MediaRouterService
- MediaRouter
- TelephonyService
- TelephonyManager
- TelephonySubscriptionService
- SubscriptionManager
- CarrierConfigService
- CarrierConfigManager
- InputMethodService
- InputMethodManager
- UiModeService
- UiModeManager
- DownloadService
- DownloadManager
- BatteryService
- BatteryManager
- JobSchedulerService
- JobScheduler
- NetworkStatsService
- NetworkStatsManager