PowerManager.GetThermalHeadroom(Int32) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
厳しい調整に達する前に、デバイスが現在持っている温度ヘッドルームの量の見積もりを提供します。
[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 ドキュメント。
このページの一部は、によって作成および共有された作業に基づく変更であり、に記載されている条件に従って使用されます。