PowerManager.GetThermalHeadroom(Int32) Methode

Definition

Gibt eine Schätzung an, wie viel thermischer Kopfraum das Gerät derzeit hat, bevor es eine schwere Drosselung erreicht.

[Android.Runtime.Register("getThermalHeadroom", "(I)F", "GetGetThermalHeadroom_IHandler", ApiSince=30)]
public virtual float GetThermalHeadroom(int forecastSeconds);
[<Android.Runtime.Register("getThermalHeadroom", "(I)F", "GetGetThermalHeadroom_IHandler", ApiSince=30)>]
abstract member GetThermalHeadroom : int -> single
override this.GetThermalHeadroom : int -> single

Parameter

forecastSeconds
Int32

wie viele Sekunden in der Zukunft prognostizieren. Da sich die Gerätebedingungen jederzeit ändern können, werden Prognosen aus der Zukunft wahrscheinlich weniger genau sein als Prognosen in naher Zukunft.

Gibt zurück

ein Wert größer oder gleich 0,0, wobei 1,0 den Schwellenwert für die SCHWERE Drosselung angibt, wie oben beschrieben. Gibt NaN zurück, wenn das Gerät diese Funktionalität nicht unterstützt oder wenn diese Funktion wesentlich schneller als einmal pro Sekunde aufgerufen wird.

Attribute

Hinweise

Gibt eine Schätzung an, wie viel thermischer Kopfraum das Gerät derzeit hat, bevor es eine schwere Drosselung erreicht.

Beachten Sie, dass dies nur versucht, den Kopfraum von langsam bewegten Sensoren wie dem Hauttemperatursensor nachzuverfolgen. Dies bedeutet, dass es keinen Vorteil gibt, diese Funktion häufiger als etwa einmal pro Sekunde aufzurufen, und Versuche, deutlich häufiger aufzurufen, können dazu führen, dass die Funktion zurückgegeben wird NaN.

Um eine genaue Prognose bereitstellen zu können, versucht das System nicht, vorherzusagen, bis es mehrere Temperaturproben enthält, aus denen extrapoliert werden soll. Dies sollte nur ein paar Sekunden ab dem Zeitpunkt des ersten Anrufs dauern, während dieser Zeit tritt jedoch keine Prognose auf, und die aktuelle Kopfzeile wird unabhängig vom Wert von forecastSecondszurückgegeben.

Der zurückgegebene Wert ist ein nicht negativer Gleitkommawert, der angibt, wie viel der verwendeten Thermischen Umschlag verwendet wird (oder voraussichtlich verwendet wird). Ein Wert von 1,0 gibt an, dass das Gerät gedrosselt #THERMAL_STATUS_SEVEREist (oder wird). Eine solche Einschränkung kann sich auf die CPU, GPU und andere Subsysteme auswirken. Werte können 1,0 überschreiten, aber es gibt keine implizite Zuordnung zu bestimmten thermischen Statusstufen, die über diesen Punkt hinausgehen. Dies bedeutet, dass Werte, die größer als 1,0 sind, möglicherweise entsprechen #THERMAL_STATUS_SEVERE, aber auch eine schwerere Drosselung darstellen.

Ein Wert von 0,0 entspricht einem festen Abstand von 1,0, entspricht jedoch keinem bestimmten thermischen Zustand oder einer bestimmten Temperatur. Werte von (0,0, 1,0] können mit temperaturmäßig linear skaliert werden, obwohl Temperaturänderungen im Laufe der Zeit normalerweise nicht linear sind. Negative Werte werden vor der Rückgabe auf 0,0 geklemmt.

Java Dokumentation für android.os.PowerManager.getThermalHeadroom(int).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für: