‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

BidirectionalStream.Builder

public abstract class BidirectionalStream.Builder

‫Builder של BidirectionalStream. מאפשר להגדיר את הסטרים לפני שיוצרים אותו באמצעות build. נוצר על ידי newBidirectionalStreamBuilder.

סיכום

ערכים קבועים
`static final int`	`STREAM_PRIORITY_HIGHEST = 4` רמת העדיפות הגבוהה ביותר לשידור.
`static final int`	`STREAM_PRIORITY_IDLE = 0` העדיפות הכי נמוכה של הזרם.
`static final int`	`STREAM_PRIORITY_LOW = 2` עדיפות נמוכה לשידור.
`static final int`	`STREAM_PRIORITY_LOWEST = 1` עדיפות נמוכה מאוד של הזרם.
`static final int`	`STREAM_PRIORITY_MEDIUM = 3` רמת עדיפות בינונית לשידור.

‫constructors ציבוריים
`Builder()`

‫methods ציבוריים
`abstract BidirectionalStream.Builder`	`addHeader(String header, String value)` מוסיף כותרת בקשה.
`BidirectionalStream.Builder`	`addRequestAnnotation(Object annotation)` משייך את אובייקט ההערה לבקשה הזו.
`BidirectionalStream.Builder`	`bindToNetwork(long networkHandle)` הפונקציה מקשרת את הבקשה לטיפול ברשת שצוין.
`abstract BidirectionalStream`	`build()` יוצרת `BidirectionalStream` באמצעות הגדרות מ-`Builder` הזה.
`abstract BidirectionalStream.Builder`	`delayRequestHeadersUntilFirstFlush( boolean delayRequestHeadersUntilFirstFlush )` השליחה של כותרות הבקשות מתעכבת עד לקריאה של `flush`.
`abstract BidirectionalStream.Builder`	`setHttpMethod(String method)` מגדירה את ה-method של ה-HTTP לבקשה.
`abstract BidirectionalStream.Builder`	`setPriority(int priority)` מגדיר את העדיפות של הזרם, שצריכה להיות אחת מ`STREAM_PRIORITY_*` הערכים.
`BidirectionalStream.Builder`	`setTrafficStatsTag(int tag)` מגדיר תג `android.net.TrafficStats` לשימוש כשמדווחים על תנועת שקעים שנגרמת כתוצאה מהבקשה הזו.
`BidirectionalStream.Builder`	`setTrafficStatsUid(int uid)` מגדיר מזהה משתמש ספציפי לשימוש כשמדובר בתנועת גולשים בשקע שנגרמת כתוצאה מהבקשה הזו.

ערכים קבועים

STREAM_PRIORITY_HIGHEST

public static final int STREAM_PRIORITY_HIGHEST = 4

רמת העדיפות הגבוהה ביותר לשידור. הועבר אל setPriority.

STREAM_PRIORITY_IDLE

public static final int STREAM_PRIORITY_IDLE = 0

העדיפות הכי נמוכה של הזרם. הועבר אל setPriority.

STREAM_PRIORITY_LOW

public static final int STREAM_PRIORITY_LOW = 2

עדיפות נמוכה לשידור. הועבר אל setPriority.

STREAM_PRIORITY_LOWEST

public static final int STREAM_PRIORITY_LOWEST = 1

עדיפות נמוכה מאוד של הזרם. הועבר אל setPriority.

STREAM_PRIORITY_MEDIUM

public static final int STREAM_PRIORITY_MEDIUM = 3

רמת עדיפות בינונית לשידור. הועבר אל setPriority. זוהי עדיפות ברירת המחדל שמוקצית לזרם.

‫constructors ציבוריים

בנאי

public Builder()

‫methods ציבוריים

addHeader

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

מוסיף כותרת בקשה. מחזירה builder כדי לאפשר שרשור.

פרמטרים
`String header`	שם הכותרת
`String value`	ערך הכותרת

החזרות
`BidirectionalStream.Builder`	הכלי ליצירת מבצעים כדי להקל על שרשור מבצעים

addRequestAnnotation

public BidirectionalStream.Builder addRequestAnnotation(Object annotation)

משייך את אובייקט ההערה לבקשה הזו. אפשר להוסיף יותר מאישור אחד. הועבר אל RequestFinishedInfo.Listener, ראו getAnnotations.

פרמטרים
`Object annotation`	אובייקט להעברה אל `RequestFinishedInfo.Listener` עם `RequestFinishedInfo`.

החזרות
`BidirectionalStream.Builder`	הכלי ליצירת שרשורים כדי להקל על יצירת שרשורים.

bindToNetwork

public BidirectionalStream.Builder bindToNetwork(long networkHandle)

הפונקציה מקשרת את הבקשה לטיפול ברשת שצוין. ‫Cronet ישלח את הבקשה הזו רק באמצעות הרשת שמשויכת ל-handle הזה. אם הרשת הזו מתנתקת, הבקשה תיכשל. השגיאה המדויקת תהיה תלויה בשלב העיבוד של הבקשה בזמן שהרשת מתנתקת. אפשר לקבל כינויים לרשת דרך Network#getNetworkHandle. התכונה זמינה רק החל מ-Android Marshmallow.

פרמטרים
`long networkHandle`	ה-handle של הרשת שאליה רוצים לקשר את הבקשה. מציינים את `UNBIND_NETWORK_HANDLE` כדי לבטל את הקישור.

החזרות
`BidirectionalStream.Builder`	הכלי ליצירת שרשורים כדי להקל על יצירת שרשורים.

לבנות גרסת build

public abstract BidirectionalStream build()

יוצרת BidirectionalStream באמצעות הגדרות מ-Builder הזה. אחרי כן אפשר להפעיל את BidirectionalStream שהוחזר על ידי קריאה ל-start.

החזרות
`BidirectionalStream`	ההגדרה האישית `BidirectionalStream` נוצרה באמצעות ההגדרה האישית `Builder`

delayRequestHeadersUntilFirstFlush

public abstract BidirectionalStream.Builder delayRequestHeadersUntilFirstFlush(
    boolean delayRequestHeadersUntilFirstFlush
)

השליחה של כותרות הבקשות מתעכבת עד שמפעילים את flush. בשלב הזה, הדגל הזה נלקח בחשבון רק כשמתנהל משא ומתן על פרוטוקול QUIC. אם הערך הוא true, פרוטוקול QUIC ישלח את מסגרת כותרת הבקשה יחד עם מסגרות הנתונים כמנה אחת, אם אפשר.

פרמטרים
`boolean delayRequestHeadersUntilFirstFlush`	אם הערך הוא true, שליחת כותרות הבקשה תתעכב עד לקריאה ל-flush().

החזרות
`BidirectionalStream.Builder`	הכלי ליצירת שרשורים כדי להקל על יצירת שרשורים.

setHttpMethod

public abstract BidirectionalStream.Builder setHttpMethod(String method)

מגדיר את ה-method של ה-HTTP לבקשה. מחזירה builder כדי לאפשר שרשור.

פרמטרים
`String method`	השיטה שבה צריך להשתמש בשביל הבקשה. ברירת המחדל היא 'POST'

החזרות
`BidirectionalStream.Builder`	הכלי ליצירת מבצעים כדי להקל על שרשור מבצעים

setPriority

public abstract BidirectionalStream.Builder setPriority(int priority)

מגדיר את העדיפות של הזרם, שצריכה להיות אחת מSTREAM_PRIORITY_* הערכים. אם לא מפעילים את ה-method הזו, הסטרים מקבל עדיפות STREAM_PRIORITY_MEDIUM.

פרמטרים
`int priority`	העדיפות של הזרם, שצריכה להיות אחת מ- `STREAM_PRIORITY_*` הערכים.

החזרות
`BidirectionalStream.Builder`	הכלי ליצירת שרשורים כדי להקל על יצירת שרשורים.

setTrafficStatsTag

public BidirectionalStream.Builder setTrafficStatsTag(int tag)

מגדיר תג android.net.TrafficStats לשימוש כשמדווחים על תנועת שקעים שנגרמת כתוצאה מהבקשה הזו. מידע נוסף זמין בandroid.net.TrafficStats. אם לא מוגדר תג (למשל, אם לא מתבצעת קריאה לשיטה הזו), מערכת Android מתייחסת לתנועת הנתונים בשקע שנגרמת מהבקשה הזו כאילו ערך התג הוגדר כ-0.

הערה: הגדרת תג אוסרת על שיתוף של שקעים עם בקשות עם תגים אחרים, וזה עלול לפגוע בביצועים כי זה מונע שיתוף חיבורים. במילים אחרות, השימוש בשקעים מרובי-ערוצים (למשל HTTP/2 ו-QUIC) יתאפשר רק אם לכל הבקשות יש אותו תג שקע.

פרמטרים
`int tag`	ערך התג שמשמש לחישוב תנועת הסוקטים שנגרמת כתוצאה מהבקשה הזו. תגים בין 0xFFFFFF00 ל-0xFFFFFFFF שמורים ומשמשים באופן פנימי את שירותי המערכת כמו `android.app.DownloadManager` כשמבצעים תעבורה בשם אפליקציה.

החזרות
`BidirectionalStream.Builder`	הכלי ליצירת שרשורים כדי להקל על יצירת שרשורים.

setTrafficStatsUid

public BidirectionalStream.Builder setTrafficStatsUid(int uid)

מגדיר מזהה משתמש ספציפי לשימוש כשמדובר בתנועת גולשים בשקע שנגרמת כתוצאה מהבקשה הזו. מידע נוסף זמין בכתובת android.net.TrafficStats. מיועד לשימוש כשמבצעים פעולה בשם אפליקציה אחרת. למתקשר צריכה להיות הרשאת MODIFY_NETWORK_ACCOUNTING. כברירת מחדל, התנועה משויכת ל-UID של המתקשר.

הערה: הגדרת UID אוסרת על שיתוף של שקעים עם בקשות עם UID אחרים, מה שעשוי להשפיע לרעה על הביצועים כי הוא אוסר על שיתוף חיבורים. במילים אחרות, השימוש בשקעים מרובי-ערוצים (למשל HTTP/2 ו-QUIC) יתאפשר רק אם לכל הבקשות מוגדר אותו מזהה ייחודי.

פרמטרים
`int uid`	מזהה המשתמש (UID) לצירוף תנועת שקעים שנגרמת כתוצאה מהבקשה הזו.

החזרות
`BidirectionalStream.Builder`	הכלי ליצירת שרשורים כדי להקל על יצירת שרשורים.