PowerManager.GetThermalHeadroom(Int32) メソッド

定義

厳しい調整に達する前に、デバイスが現在持っている温度ヘッドルームの量の見積もりを提供します。

[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

パラメーター

forecastSeconds
Int32

予測する秒数。 デバイスの状態はいつでも変化する可能性があるため、今後の予測は近い将来の予測よりも正確ではなくなる可能性があります。

戻り値

0.0 以上の値 。1.0 は、前述のように SEVERE 調整しきい値を示します。 デバイスがこの機能をサポートしていない場合、またはこの関数が 1 秒に 1 回よりも大幅に高速に呼び出される場合は、NaN を返します。

属性

注釈

厳しい調整に達する前に、デバイスが現在持っている温度ヘッドルームの量の見積もりを提供します。

これは、皮膚温度センサーなど、動きの遅いセンサーのヘッドルームの追跡のみを試みる点に注意してください。 つまり、この関数を 1 秒に 1 回ほど頻繁に呼び出してもメリットはなく、呼び出そうとする頻度が大幅に高いと、関数が を返す NaN可能性があります。

さらに、正確な予測を提供できるようにするために、システムは、複数の温度サンプルを外挿するまで予測を試みません。 これは、最初の呼び出しの時刻から数秒しかかからなくなりますが、この間は予測は行われず、 の forecastSeconds値に関係なく現在のヘッドルームが返されます。

返される値は、使用されている温度エンベロープの量 (または使用中と予測される) を表す負以外の浮動小数点数です。 値 1.0 は、デバイスが で #THERMAL_STATUS_SEVERE調整されていることを示します。 このような調整は、CPU、GPU、およびその他のサブシステムに影響を与える可能性があります。 値が 1.0 を超える場合がありますが、その時点を超える特定の温度状態レベルへの暗黙的なマッピングはありません。 つまり、1.0 より大きい値は に対応している #THERMAL_STATUS_SEVERE可能性がありますが、より重い調整を表す場合もあります。

値 0.0 は 1.0 からの固定距離に対応しますが、特定の温度の状態や温度には対応しません。 (0.0, 1.0] の値は、温度に応じて線形にスケーリングされることが予想される場合がありますが、時間の経過に伴う気温の変化は通常、線形ではありません。 負の値は、戻る前に 0.0 にクランプされます。

android.os.PowerManager.getThermalHeadroom(int)Java ドキュメント。

このページの一部は、によって作成および共有された作業に基づく変更であり、に記載されている条件に従って使用されます。

適用対象