rtpengine中rtpengine_manage()函数支持的参数

rtpengine中rtpengine_manage()函数支持的参数：
用法：rtpengine_manage("replace-origin replace-session-connection xxx  xxx"); xxx就是下面的参数：

via-branch=... - 可能的值为：“1” - 使用第一个“Via”标头;“2” - 使用第二个“Via”标头;“auto” - 如果这是请求，则使用第一个“Via”标头。

asymmetric - 标记接收信息的 UA 不支持对称 RTP。禁止在 Sipwise rtpengine 代理中学习端点地址。

no-redis-update - 该标志可用于告诉 rtpengine 在收到 offer/answer() 控制命令时不要将调用持久化到 Redis 中。如果未设置该标志，默认操作是 rtpengine 将调用持久化到 Redis。

force-answer - 强制 "应答"，即只在 RTP 代理中已存在相应会话时重写 SDP。默认情况下，当会话即将结束时，该选项为开启。只有通过 rtpengine_offer()发送要约，并通过 rtpengine_manage()处理应答时，才有必要这样做。

direction=... - 该选项指定了一个逻辑网络接口，应准确给出两次。它可以在不同地址或同族网络（如 IPv4 到 IPv4）之间进行 RTP 桥接。该选项的第一个实例指定该信息的发起方应使用的接口，第二个实例指定目标方应使用的接口。例如，如果 SIP 信息是由专用网络上的端点发送的，并将被发送到公共互联网上的端点，那么如果这两个逻辑网络接口在 RTP 代理配置中分别称为 "priv "和 "pub"，则应使用 "direction=priv direction=pub"。方向必须只在初始 SDP 提议中指定；应答或后续提议可以省略此选项。

internal, external - 分别是 "direction=internal（内部）"和 "direction=external（外部）"的简称。如果 RTP 代理只支持两个网络接口，而不是多个任意命名的网络接口，则可作为简洁性或传统选项使用。

address-family=... - 指示 RTP 代理，该 SDP 主体的接收方希望看到特定系列的地址。可能的值有 "IP4 "和 "IP6"。例如，如果 SDP 主体包含 IPv4 地址，但接收方只说 IPv6，则应使用 "address-family=IP6 "在两个地址系列之间架桥。

force - 指示 RTP 代理忽略另一个 RTP 代理在传输过程中插入的标记，以表明会话已通过另一个代理。允许创建代理链。Sipwise rtpengine 不支持并忽略该标记。

trust-address - 标记，表明 SDP 中的 IP 地址应被信任。从 rtpengine 3.8 开始，这是默认行为。在旧版本中，如果没有这个标记，RTP 代理会忽略 SDP 中的地址，并使用 SIP 消息的源地址作为媒体地址传递给 RTP 代理。

SIP-source-address - 与 trust-address 相反。恢复旧的默认行为，即忽略 SDP 主体中的端点地址。

received-from=IP - 明确配置 SIP 源地址 IP，这在两个 kamailio 级联时非常有用，其中第一个 kamailio 处理 NAT，第二个 kamailio 处理 RTPEngine。

replace-origin - (o=) 表明这个IP应该被改写。

replace-session-connection - 标记，用于在媒体描述也包含连接信息时更改会话级 SDP 连接 (c=) IP。

symmetric - 标记必须强制接收信息的 UA 支持对称 RTP。对 Sipwise rtpengine 代理不做任何操作，因为它是默认设置。

repacketize=NN - 请求 RTP 代理对来自发送当前信息的 UA 的 RTP 流量进行重新分包，以尽可能增大或减小转发的每个 RTP 数据包的有效载荷大小。NN 是以毫秒为单位的目标有效载荷大小，对于大多数编解码器来说，其值应以 10 毫秒为增量，但对于某些编解码器来说，增量可能不同（如 GSM 为 30 毫秒，G.723 为 20 毫秒）。RTP 代理将选择编解码器支持的最接近的值。该功能可用于大幅减少低比特率编解码器的带宽开销，例如，G.729 从 10ms 增至 100ms，可节省三分之二的网络带宽。Sipwise rtpengine 不支持。

ICE=... - 控制 RTP 代理对 SDP 主体中 ICE 属性的行为。可能的值有 "强制"（force）--丢弃 SDP 主体中已存在的任何 ICE 属性，然后生成并插入新的 ICE 数据，使自己成为唯一的 ICE 候选者；"强制中继"（force-relay）--丢弃 SDP 主体中已存在的任何 "中继 "类型 ICE 属性，然后生成并插入自己作为唯一的 ICE "中继 "候选者；"删除"（remove）指示 RTP 代理丢弃任何 ICE 属性，不在 SDP 中插入任何新属性。默认情况下（如果没有给出 "ICE=..."），只有当 SDP 中原本没有 ICE 时，才会生成新的 ICE 数据；否则，RTP 代理只会插入自己作为额外的 ICE 候选者。其他 SDP 替换（c=、m= 等）不受此标记的影响。

RTP, SRTP, DTLS, AVP, AVPF - 这些标志控制着应向 SDP 接收方使用的 RTP 传输协议。如果没有指定，SDP 中给出的协议将保持不变。否则，"SRTP "标志表示应使用 SRTP，而 "RTP "则表示不应使用 SRTP 和 AVPF。"AVPF "表示应使用带有反馈信息的高级 RTCP 配置文件，而 "AVP "表示应使用常规 RTCP 配置文件。另请参阅下面的标志集。

RTP/AVP, RTP/SAVP, UDP/TLS/RTP/SAVP, RTP/AVPF, RTP/SAVPF, UDP/TLS/RTP/SAVPF - 这些标志是在 RTP 代理支持的不同 RTP 协议和配置文件之间进行选择的另一种更明确的方式。例如，标记 "RTP/SAVPF "与标记 "SRTP AVPF "的效果相同。

to-tag - 强制包含 "收件人 "标记。通常情况下，"收件人 "标记出现时总是包含在内，但 "删除 "信息除外。在 "删除 "信息中包含 "收件人 "标记可以让您更有选择性地删除通话中的哪些对话。

to-tag=... - 使用指定的字符串作为 "收件人 "标记，而不是 SIP 消息中的实际 "收件人 "标记，并按上文所述在消息中强制包含该标记。

from-tag=... - 使用指定的字符串作为 "From "标记，而不是 SIP 消息中的实际 "From "标记。

call-id=... - 使用指定字符串作为 "Call-ID"，而不是 SIP 消息中的实际 "Call-ID"。

rtcp-mux-demux - 如果提供了 rtcp-mux（RFC 5761），则使 RTP 代理接受该提议，但不向该信息的接收者提供。

rtcp-mux-reject - 如果提供了 rtcp-mux，则使 RTP 代理拒绝提供，但仍向收件人提供。可与 "rtcp-mux-offer "结合使用，以始终提供。

rtcp-mux-offer - 使 RTP 代理向该信息的接收者提供 rtcp-mux，无论最初是否提供过。

rtcp-mux-accept - 如果提供了 rtcp-mux，则使 RTP 代理接受该提议，并将其提供给该信息的收件人。可与 "rtcp-mux-offer "结合使用，以始终提供该服务。

media-address=... - 强制在 SDP 主体中使用特定媒体地址。地址族会自动检测。

TOS=... - 更改双向呼叫中所有传出 RTP 数据包的 IP TOS 值。只在 "要约 "中使用，在 "应答 "中忽略。有效值为 0 至 255（十进制）。如果未指定该选项，TOS 值将恢复为默认 TOS（通常为 184）。如果值为-1，则当前使用的 TOS 将保持不变。

delete-delay=... - 覆盖从内存中实际删除呼叫前的默认延迟（以秒为单位）。可设置为 0 以实现立即删除。该选项只适用于删除操作。

strict-source - 指示 RTP 代理检查所有传入 RTP 数据包的源地址，如果地址不匹配，则丢弃数据包。

media-handover - 严格源地址的对立面。指示 RTP 代理不仅接受不匹配的 RTP 源地址（通常情况下会这样做），而且接受它们作为相反媒体流的新端点地址。不建议使用，因为它允许媒体流被攻击者劫持。

DTLS=... - 影响 DTLS-SRTP 的行为。可能的值有 "否 "或 "关闭"，表示禁止提供或接受 DTLS-SRTP；"被动 "表示更愿意以被动角色参与 DTLS-SRTP。

SDES-off - 在正常情况下不提供 SDES。在 SRTP 环境下，DTLS-SRTP 就成了唯一的选择。

SDES-unencrypted_srtp, SDES-unencrypted_srtcp, SDES-unauthenticated_srtp - 这些直接反映了 RFC 4568 中的 SDES 会话参数，并将使 RTP 代理在提供 SDES 时提供这些参数。

SDES-encrypted_srtp, SDES-encrypted_srtcp, SDES-authenticated_srtp - 与上述标志相反。如果不希望接受这些参数，而应拒绝接受它们，则该标志非常有用。

SDES-nonew - 不在报价中添加任何新的加密套包。这意味着提供的 SDES 加密套件将被接受，同时 RTPEngine 不会生成新的加密套件。如果同时使用 "SDES-no "和 "SDES-only "标志，它优先于 "SDES-no "和 "SDES-only "标志。

SDES-pad - RFC 4568（第 6.1 节）对于添加到 SDP 主体中的 `a=crypto` 参数的 base64 编码格式有些含糊不清。默认的解释是，用于填充的尾部 `=` 字符应省略。设置此标记后，这些填充字符将被保留。

unidirectional - 允许在 Sipwise rtpengine 代理中将单向流内核化。当第一个调用段由某个 rtpengine 机器处理，而第二个调用段由其他 rtpengine 机器处理时，这一点尤其有用。

record-call=on - 指示 RTPEngine 录制会话。在 rtpengine_offer() 中使用它可立即开始录音并保存呼叫元数据，作为 start_recording() 的替代。这个非常重要，只有这里on了，才会在recording-dir = /var/spool/rtpengine目录下生成pcap文件。

metadata - 通用元数据字符串。元数据将在记录呼叫时使用，以提供自定义的附加信息。更多详情请参见 rtpengine README。

codec-transcode=... - 允许将编解码器添加到提供的编解码器列表中，即使这些编解码器不在原始编解码器列表中。在这种情况下，将启用转码引擎。只有同时支持解码和编码的编解码器才能以这种方式添加。有关这方面的更多详情，请参阅 rtpengine README。

codec-set=... - 为编码解码器设置编码解码器选项（比特率等），这些编码解码器隐含地接受提供方的转码。

codec-strip=... - 从 sdp 中删除指定的编解码器

codec-offer=... - 提供给定的编码解码器。更多详情请参见 rtpengine README。就是增加几个编码解码器。

codec-except=... - 与 codec-offer 相同，但保留原始顺序

codec-mask=... - 与 strip 类似，但此处列出的编解码器仍会被接受并用于提供方的转码。all 关键字可用于屏蔽所有提供的编解码器。

codec-accept=... - 与 `mask` 和 `consume` 类似，但不会从提供的编解码器列表中删除编解码器。这意味着列在 `accept` 下的编解码器仍会提供给远程对等设备，但如果远程对等设备拒绝接受，它仍会被原始提供者接受，然后用于转码。这是 "始终转码 "标记的一个更具选择性的版本。

T.38=decode - 如果提供的 SDP 包含通过 UDPTL 宣传 T.38 的媒体部分，则将其翻译为通过 RTP 的普通音频媒体部分。默认情况下，PCMU 和 PCMA 将被用作音频编解码器，但可以使用上述编解码器选项覆盖。也可以用同样的方法选择其他传输协议（如 SRTP）。如果提供的 SDP 不包含 T.38 部分，则此标记无效。

T.38=force - 提供的 SDP 中的任何音频媒体部分（通过 RTP）都将被翻译成通过 UDPTL 的 T.38 部分。

T.38=stop - 停止先前建立的 T.38 转音频网关，并将会话恢复为媒体直通。这在处理被拒绝的 T.38 提议时非常有用