DnsOptions.StaleDnsOptions.Builder

fun allowCrossNetworkUsage(allowCrossNetworkUsage: Boolean): DnsOptions.StaleDnsOptions.Builder!

設定是否要傳回來自其他網路的結果。一般來說，Cronet 會在切換連線時完全清除 DNS 快取，例如在兩個 Wi-Fi 網路之間切換，或是從 Wi-Fi 切換到 4G。

fun build(): DnsOptions.StaleDnsOptions!

根據這個建構工具中的值，建立並傳回最終的 StaleDnsOptions 例項。

@RequiresApi(value = VERSION_CODES.O)
fun setFreshLookupTimeout(freshLookupTimeout: Duration): DnsOptions.StaleDnsOptions.Builder!

與 setFreshLookupTimeoutMillis 相同，但使用 java.time.Duration。

fun setFreshLookupTimeoutMillis(freshLookupTimeoutMillis: Long): DnsOptions.StaleDnsOptions.Builder!

設定 DNS 要求的回傳等待時間 (以毫秒為單位)，如果超過這個時間，則改用過時結果。如果設為零，系統會立即傳回過時的結果，但會在背景繼續執行 DNS 要求，以更新快取。

@RequiresApi(value = VERSION_CODES.O)
fun setMaxExpiredDelay(maxExpiredDelay: Duration): DnsOptions.StaleDnsOptions.Builder!

與 setMaxExpiredDelayMillis 相同，但使用 java.time.Duration。

fun setMaxExpiredDelayMillis(maxExpiredDelayMillis: Long): DnsOptions.StaleDnsOptions.Builder!

設定過期結果的可用時間 (以毫秒為單位)。如果將值設為零，過期記錄就能無限期使用。

fun useStaleOnNameNotResolved(useStaleOnNameNotResolved: Boolean): DnsOptions.StaleDnsOptions.Builder!

設定網路解析器無法解析主機名稱時，是否允許使用過時的 DNS 結果。

視用途而定，如果 Cronet 快速發現新的失敗，或許會想使用該失敗，因為這在技術上是最新結果，而且我們很快就取得這類最新結果；或者，寧願使用任何結果 (即使是過時結果)，也不要失敗。