BidirectionalStream.Builder

public static final int STREAM_PRIORITY_HIGHEST = 4

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

public static final int STREAM_PRIORITY_IDLE = 0

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

public static final int STREAM_PRIORITY_LOW = 2

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

public static final int STREAM_PRIORITY_LOWEST = 1

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

public static final int STREAM_PRIORITY_MEDIUM = 3

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

public abstract BidirectionalStream.Builder addHeader(String header, String value)

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

public BidirectionalStream.Builder addRequestAnnotation(Object annotation)

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

public BidirectionalStream.Builder bindToNetwork(long networkHandle)

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

public abstract BidirectionalStream build()

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

public abstract BidirectionalStream.Builder delayRequestHeadersUntilFirstFlush(
    boolean delayRequestHeadersUntilFirstFlush
)

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

public abstract BidirectionalStream.Builder setHttpMethod(String method)

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

public abstract BidirectionalStream.Builder setPriority(int priority)

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

public BidirectionalStream.Builder setTrafficStatsTag(int tag)

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

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

public BidirectionalStream.Builder setTrafficStatsUid(int uid)

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

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