BidirectionalStream.Builder

const val STREAM_PRIORITY_HIGHEST = 4: Int

ストリームの優先度が最も高い。setPriority に渡されました。

const val STREAM_PRIORITY_IDLE = 0: Int

ストリームの優先度が最も低い。setPriority に渡されました。

const val STREAM_PRIORITY_LOW = 2: Int

ストリームの優先度が低い。setPriority に渡されました。

const val STREAM_PRIORITY_LOWEST = 1: Int

ストリームの優先度が非常に低い。setPriority に渡されました。

const val STREAM_PRIORITY_MEDIUM = 3: Int

中程度のストリーム優先度。setPriority に渡されました。これはストリームに割り当てられるデフォルトの優先度です。

abstract fun addHeader(header: String!, value: String!): BidirectionalStream.Builder!

リクエスト ヘッダーを追加します。チェーンを容易にするためにビルダーを返します。

fun addRequestAnnotation(annotation: Any!): BidirectionalStream.Builder!

アノテーション オブジェクトをこのリクエストに関連付けます。複数追加できます。RequestFinishedInfo.Listener に渡されます。getAnnotations をご覧ください。

fun bindToNetwork(networkHandle: Long): BidirectionalStream.Builder!

リクエストを指定されたネットワーク ハンドルにバインドします。Cronet は、このハンドルに関連付けられたネットワークのみを使用してこのリクエストを送信します。このネットワークが切断されると、リクエストは失敗します。正確なエラーは、ネットワークが切断されたときのリクエスト処理の段階によって異なります。ネットワーク ハンドルは Network#getNetworkHandle を介して取得できます。Android Marshmallow 以降でのみ利用可能です。

abstract fun build(): BidirectionalStream!

この Builder の構成を使用して BidirectionalStream を作成します。返された BidirectionalStream は、start を呼び出すことで開始できます。

abstract fun delayRequestHeadersUntilFirstFlush(
    delayRequestHeadersUntilFirstFlush: Boolean
): BidirectionalStream.Builder!

flush が呼び出されるまでリクエスト ヘッダーの送信を遅延させます。このフラグは現在、QUIC がネゴシエートされている場合にのみ反映されます。true の場合、QUIC は可能な限り、リクエスト ヘッダー フレームとデータフレームを 1 つのパケットとして送信します。

abstract fun setHttpMethod(method: String!): BidirectionalStream.Builder!

リクエストの HTTP メソッドを設定します。チェーンを容易にするためにビルダーを返します。

abstract fun setPriority(priority: Int): BidirectionalStream.Builder!

ストリームの優先度を設定します。これは STREAM_PRIORITY_* 値のいずれかである必要があります。このメソッドが呼び出されない場合、ストリームには STREAM_PRIORITY_MEDIUM の優先度が与えられます。

fun setTrafficStatsTag(tag: Int): BidirectionalStream.Builder!

このリクエストによって発生したソケット トラフィックをアカウンティングする際に使用する android.net.TrafficStats タグを設定します。詳しくは、android.net.TrafficStats をご覧ください。タグが設定されていない場合（このメソッドが呼び出されていない場合など）、Android は、このリクエストによって発生したソケット トラフィックを、タグ値が 0 に設定されているかのように処理します。

注: タグを設定すると、他のタグのリクエストとのソケットの共有が禁止され、接続の共有が禁止されることでパフォーマンスに悪影響が及ぶ可能性があります。つまり、すべてのリクエストに同じソケットタグがある場合にのみ、多重化ソケット（HTTP/2 や QUIC など）の使用が許可されます。

fun setTrafficStatsUid(uid: Int): BidirectionalStream.Builder!

このリクエストによって発生したソケット トラフィックをアカウンティングする際に使用する特定の UID を設定します。詳しくは、android.net.TrafficStats をご覧ください。別のアプリケーションの代わりにオペレーションを実行するときに使用するように設計されています。呼び出し元には MODIFY_NETWORK_ACCOUNTING 権限が必要です。デフォルトでは、トラフィックは呼び出し元の UID に関連付けられます。

注: UID を設定すると、他の UID を持つリクエストとのソケットの共有が禁止され、接続の共有が禁止されることでパフォーマンスに悪影響を及ぼす可能性があります。つまり、すべてのリクエストに同じ UID が設定されている場合にのみ、多重化ソケット（HTTP/2 や QUIC など）の使用が許可されます。