2.2.3 Bandwidth Reservation Amount
The Bandwidth Reservation Amount attribute is used by the client to indicate the amount of bandwidth that the Bandwidth Admission Control Message is requesting. This attribute MUST be included in all Reservation Check request messages and Reservation Commit messages. It MUST be included in a Reservation Update message that requests a change in the bandwidth reservation amount.
When the client includes this attribute as part of a Reservation Check request message, the bandwidth values MUST identify the bandwidth range (minimum and maximum) for the client’s media stream.
When the client includes this attribute as part of a Reservation Commit message, the bandwidth values MUST be set to the bandwidth that the client expects to use for the media stream. The server MUST commit the bandwidth reservation for the maximum amounts indicated in the attribute.
When the client includes this attribute as part of a Reservation Update message, the bandwidth values can be less than, greater than, or equal to the committed bandwidth reservation value. If the client is using a Reservation Update to ask for an increase in the bandwidth reservation, and the server is not able to honor the increase it MUST deny the Reservation Update. If the client sends a Reservation Update with the bandwidth values set to zero, the server treats the message as a cancellation of the reservation and releases the bandwidth committed to the reservation. If the server is not being used to relay the media stream and the reservation is released, the server MUST disconnect the TURN session. When the server includes this attribute in the response to a Reservation Update, the bandwidth values specify the amount of bandwidth that the server (2) has reserved for the client’s media stream.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Attribute Type |
Attribute Length |
||||||||||||||||||||||||||||||
|
Minimum Send Bandwidth |
|||||||||||||||||||||||||||||||
|
Maximum Send Bandwidth |
|||||||||||||||||||||||||||||||
|
Minimum Receive Bandwidth |
|||||||||||||||||||||||||||||||
|
Maximum Receive Bandwidth |
|||||||||||||||||||||||||||||||
Attribute Type (2 bytes): The TURN attributes are specified in [IETFDRAFT-STUN-02] section 10.2 and [IETFDRAFT-TURN-08] section 9.2. Set to "0x8058".
Attribute Length (2 bytes): Length of the following fields. Set to "0x0010".
Minimum Send Bandwidth (4 bytes): The minimum bandwidth requirements, in kilobits per second, for the client’s outbound media stream.
Maximum Send Bandwidth (4 bytes): The maximum bandwidth requirements, in kilobits per second, for the client’s outbound media stream.
Minimum Receive Bandwidth (4 bytes): The minimum bandwidth requirements, in kilobits per second, for the client’s inbound media stream.
Maximum Receive Bandwidth (4 bytes): The maximum bandwidth requirements, in kilobits per second, for the client’s inbound media stream.