Skip to Main content
検索にジャンプ
Skip to Footer

開発者用 SIP 透過性および正規化ガイド

偏向のない言語

この製品のマニュアルセットは、偏向のない言語を使用するように配慮されています。このマニュアルセットでの偏向のない言語とは、年齢、障害、性別、人種的アイデンティティ、民族的アイデンティティ、性的指向、社会経済的地位、およびインターセクショナリティに基づく差別を意味しない言語として定義されています。製品ソフトウェアのユーザーインターフェイスにハードコードされている言語、RFP のドキュメントに基づいて使用されている言語、または参照されているサードパーティ製品で使用されている言語によりドキュメントに例外が存在する場合があります。シスコのインクルーシブランゲージに対する取り組みの詳細は、こちらをご覧ください。

翻訳について

このドキュメントは、米国シスコ発行ドキュメントの参考和訳です。リンク情報につきましては、日本語版掲載時点で、英語版にアップデートがあり、リンク先のページが移動/変更されている場合がありますことをご了承ください。あくまでも参考和訳となりますので、正式な内容については米国サイトのドキュメントを参照ください。

マニュアルのコンテンツ

このマニュアル内で検索

ご利用いただける言語

Download Options

Book Title

開発者用 SIP 透過性および正規化ガイド

Chapter Title

SDP API

PDF - Complete Book (2.42 MB) PDF - This Chapter (632.0 KB)
View with Adobe Reader on a variety of devices

検索結果

Updated:: 2017年6月14日

章のタイトル： SDP API

行レベルの API
メディア記述レベルの API

SDP API

この章では、Session Description Protocol（SDP; セッション記述プロトコル）のコンテンツ本文に関連した API について説明します。SDP は、SIP Message オブジェクトとは違って、基本文字列として扱われます。このため、スクリプト作成者は、Lua の文字列ライブラリの機能を利用することが可能です。Lua 文字列ライブラリの関数に加えて、シスコからも SDP 操作を支援するための API をいくつかご用意しています。Cisco API は文字列ライブラリに直接追加されますが、

スクリプトで SDP を操作するには、まず Lua SIP Message オブジェクトで提供される getSdp() API を使用して Lua SIP Message オブジェクトから SDP コンテンツ本文を取得する必要があります。その後は、スクリプト内で Cisco API に含まれる文字列ライブラリを使用して、SDP を操作できます。修正を終えたら、SIP Message オブジェクトに用意されている setSdp(sdp) API を使用して、SDP を SIP Message オブジェクトに書き戻します。これらの API の詳細については、次の「SIP メッセージの API」を参照してください。

-- Get the SDP content body from the SIP message

local sdp = msg:getSdp()

-- modification of the SDP happens at this point

-- Update the SDP associated with the SIP message

msg: etSdp(sdp)

シスコからは、SDP を操作するという目的で、個々の行およびメディア記述全体の取得、修正、追加、挿入、削除を行う API を用意しています。この章の以降の部分では、これらの Cisco API について説明します。

SDP の任意の行を取得して操作するには、行を識別する手段が必要です。スクリプト作成者は、無効な SDP に影響できなければなりません。したがって、正規化のために SDP の構造を知っておくことが最低限必要です。無効な SDP に影響することは、不可能ではないにしても難しいです。有効な SDP を操作することも可能です。これらの目標を念頭に置いて、文字列ベースのアプローチが保証されています。

SDP を操作するための Lua API は、大きく分けると 2 つのカテゴリに分類されます。

• 「行レベルの API」：この一連の API は、SDP 内の行を取得して操作できるようになっています。

• 「メディア記述レベルの API」：この一連の API は、特定のメディア記述を操作するためのものです。

セッションレベルの行の操作には、行レベルの一連の API を使用し、メディア記述の操作には、メディア記述レベルの一連の API を使用します。

（注）行を操作するために設計された一連の API の操作対象は、セッションレベルの行のみに限定されるわけではありません。

行レベルの API

Cisco API より

次の行レベル Cisco API が使用可能です。

• 「getLine」 (start-of-line, line-contains)

• 「modifyLine」 (start-of-line, line-contains, new- line)

• 「addline」 (new-line)

• 「insertLineAfter」 (start-of-line, line-contains, new-line)

• 「insertLineBefore」 (start-of-line, line-contains, new-line)

• 「removeLine」 (start-of-line, line-contains)

パラメータの説明

パラメータ	説明
sdp	sdp パラメータは、SDP の入った文字列です。制御文字（「\r」、「\n」など）もすべて含みます。API は、sdp パラメータについて SDP 構造を一切強制しません。単なる文字列として扱います。スクリプト作成者は、SDP の一部分（たとえば、音声メディア記述など）を操作するのにこの API を使用できます。
start-of-line	start-of-line パラメータは、sdp 内の行の開始を探すのに使用される文字列です。一般的なスクリプトでは、たとえば、「o=」、「a=rtpmap:9」などが sdp 内のこの文字列で始まる最初の行の取得/修正/挿入/削除に使用できます。この文字列で始まる行が複数存在する場合は、最初の行だけが操作対象となります。このパラメータは、<char>=<string> という形式になっていなければなりません。つまり、2 文字目が必ず等号でなくてはなりません。このパラメータがこの形式になっていない場合は、「nil」が返されます。
line-contains	line-contains は、「start-of-line」パラメータに指定した文字列で開始する行内で検索する、追加の一致条件として使用される文字列です。nil を指定した場合、 line-contains は一致条件として使用されません。その場合、 start-of-line パラメータだけが行の検索に使用されます。 line-contains が nil でなければ、 start-of-line と line-contains の両方が検索に使用されます。SDP 内に検索条件（両方）に一致する行が複数存在する場合は、最初の行だけが返されます。このパラメータで指定するこの追加の一致条件が必要ない場合は、値として「nil」を引用符なしで渡す必要があります。
new-line	new-line は、最終的な sdp（返された sdp）に追加/挿入する文字列です。

上記 API は、これらのパラメータを文字列として扱います。このため、セッションレベルの行とメディアレベルの行の両方を操作できます。行がセッションレベルかメディアレベルかに応じて動作が変わることは一切ありません。条件に一致する行を検索する際、各行は \n （または \r\n ）で終わるものとします。

パラメータ内の文字はいずれも Lua の「マジックキャラクタ」とは見なされません。すべての文字が、特別な意味は一切持たず、プレーン文字として扱われます。

getLine

sdp:getLine(start-of-line, line-contains) returns string

このメソッドは、sdp 内の start-of-line で開始して文字列 line-contains を持つ最初の行を返します。

例：SDP から c 行を取得して、ローカル変数に値として格納します。

スクリプト

M = {}

function M.outbound_INVITE(msg)

local sdp = msg:getSdp()

if sdp

then

local ipv4_c_line = sdp:getLine("c=", "IP4")

end

end

return M

メッセージ

INVITE sip:901@rawlings.cisco.com:5080 SIP/2.0

.

Content-Type: application/sdp

v=0

o=CiscoSystemsCCM-SIP 2000 1 IN IP4 172.18.197.88

s=SIP Call

c=IN IP4 172.18.197.88

t=0 0

m=audio 24580 RTP/AVP 0 101

a=rtpmap:0 PCMU/8000

a=ptime:20

a=rtpmap:101 telephone-event/8000

a=fmtp:101 0-15

出力/結果

Local variable ipv4_c_line is set to "c=IN IP4 172.18.197.88\r\n"

modifyLine

sdp:modifyLine(start-of-line, line-contains, new-line)

このメソッドは、「sdp」内で start-of-line で開始する行を探します。 line-contains パラメータが nil でない場合は、それもその行内に存在している必要があります。一致する行（行終了文字を含む）が、 new-line パラメータで置き換えられます。得られた sdp が返されます。

一致する行が見つからない場合は、元の sdp が未変更のまま返されます。

（注） SDP のルールに従うために、new-line には \r\n（または \n）で終了する文字列を指定することを推奨します。ユーティリティによって行終了文字が強制されることはありません。

例：次のコードは、a= 行の G.722 コーデックをドットのない G722 に変更します。

スクリプト

M = {}

function M.inbound_INVITE(msg)

local sdp = msg:getSdp()

if sdp

then

local g722_line = sdp:getLine("a=","G.722")

if g722_line

then

--Replace G.722 with G722. The dot is special and must be

--escaped using % when using gsub.

g722_line = g722_line:gsub("G%.722", "G722")

sdp = sdp:modifyLine("a=", "G.722", g722_line)

msg:setSdp(sdp)

end

end

end

return M

メッセージ

INVITE sip:901@rawlings.cisco.com:5080 SIP/2.0

.

Content-Type: application/sdp

v=0

o=CiscoSystemsCCM-SIP 2000 1 IN IP4 172.18.197.22

s=SIP Call

c=IN IP4 172.18.197.29

t=0 0

m=audio 23588 RTP/AVP 9 0 8 18 101

a=rtpmap:9 G.722/8000

a=ptime:20

a=rtpmap:0 PCMU/8000

a=ptime:20

a=rtpmap:8 PCMA/8000

a=ptime:20

a=rtpmap:18 G729/8000

a=ptime:20

a=fmtp:18 annexb=no

a=rtpmap:101 telephone-event/8000

a=fmtp:101 0-15

出力/結果

INVITE sip:901@rawlings.cisco.com:5080 SIP/2.0

.

Content-Type: application/sdp

v=0

o=CiscoSystemsCCM-SIP 2000 1 IN IP4 172.18.197.22

s=SIP Call

c=IN IP4 172.18.197.29

t=0 0

m=audio 23588 RTP/AVP 9 0 8 18 101

a=rtpmap:9 G722/8000

a=ptime:20

a=rtpmap:0 PCMU/8000

a=ptime:20

a=rtpmap:8 PCMA/8000

a=ptime:20

a=rtpmap:18 G729/8000

a=ptime:20

a=fmtp:18 annexb=no

a=rtpmap:101 telephone-event/8000

a=fmtp:101 0-15

addline

sdp:addLine(new-line)

このメソッドは、SDP の末尾に new-line を追加します。SDP のルールに従うために、 new-line には \r\n （または \n ）で終了する文字列を指定することを推奨します。この API によって行終了文字が強制されることはありません。

例：SDP の末尾に属性行を追加します。

スクリプト

M = {}

function M.outbound_INVITE(msg)

local sdp = msg:getSdp()

if sdp

then

sdp = sdp:addLine("a=some-attribute\r\n")

msg:setSdp(sdp)

end

end

return M

メッセージ

INVITE sip:901@rawlings.cisco.com:5080 SIP/2.0

.

Content-Type: application/sdp

v=0

o=CiscoSystemsCCM-SIP 2000 1 IN IP4 172.18.197.88

s=SIP Call

c=IN IP4 172.18.197.88

t=0 0

m=audio 24690 RTP/AVP 0 101

a=rtpmap:0 PCMU/8000

a=ptime:20

a=rtpmap:101 telephone-event/8000

a=fmtp:101 0-15

出力/結果

INVITE sip:901@rawlings.cisco.com:5080 SIP/2.0

.

Content-Type: application/sdp

v=0

o=CiscoSystemsCCM-SIP 2000 1 IN IP4 172.18.197.88

s=SIP Call

c=IN IP4 172.18.197.88

t=0 0

m=audio 24690 RTP/AVP 0 101

a=rtpmap:0 PCMU/8000

a=ptime:20

a=rtpmap:101 telephone-event/8000

a=fmtp:101 0-15

a=some-attribute

insertLineAfter

sdp:insertLineAfter(start-of-line, line-contains, new-line)

このメソッドは、sdp 内で start-of-line で開始し、なおかつ line-contains パラメータが指定されていればその行内に line-contains も持つ最初の行を探します。次に、見つかった行の後ろに new-line を挿入します。

例：SDP 内の「a=」および「G729」を持つ行の後ろに行を 1 つ挿入します。

スクリプト

M = {}

function M.outbound_INVITE(msg)

local sdp = msg:getSdp()

if sdp

then

sdp = sdp:insertLineAfter("a=", "G729", "a=ptime:30\r\n")

msg:setSdp(sdp)

end

end

return M

メッセージ

INVITE sip:901@rawlings.cisco.com:5080 SIP/2.0

.

Content-Type: application/sdp

v=0

o=CiscoSystemsCCM-SIP 2000 1 IN IP4 172.18.197.22

s=SIP Call

c=IN IP4 172.18.197.29

t=0 0

m=audio 21702 RTP/AVP 18 101

a=rtpmap:18 G729/8000

a=fmtp:18 annexb=no

a=rtpmap:101 telephone-event/8000

a=fmtp:101 0-15

出力/結果

INVITE sip:901@rawlings.cisco.com:5080 SIP/2.0

.

Content-Type: application/sdp

v=0

o=CiscoSystemsCCM-SIP 2000 1 IN IP4 172.18.197.22

s=SIP Call

c=IN IP4 172.18.197.29

t=0 0

m=audio 21702 RTP/AVP 18 101

a=rtpmap:18 G729/8000^M

a=ptime:30

a=fmtp:18 annexb=no

a=rtpmap:101 telephone-event/8000

a=fmtp:101 0-15

insertLineBefore

sdp:insertLineBefore(start-of-line, line-contains, new-line)

このメソッドは、sdp 内で start-of-line で開始し、なおかつ line-contains パラメータが指定されていればその行内に line-contains も持つ最初の行を探します。次に、見つかった行の前に new-line を挿入します。

例：SDP 内の「s=」行の前に行を 1 つ挿入します。

スクリプト

M = {}

function M.inbound_ANY_INVITE(msg)

local sdp = msg:getSdp()

if sdp

then

sdp= sdp:insertLineBefore("s=", nil, "e=nobody@cisco.com\r\n")

msg:setSdp(sdp)

end

end

return M

メッセージ

SIP/2.0 200 OK

.

Content-Type: application/sdp

v=0

o=CiscoSystemsCCM-SIP 2000 1 IN IP4 172.18.197.22

s=SIP Call

c=IN IP4 172.18.197.29

t=0 0

m=audio 17774 RTP/AVP 9 101

a=rtpmap:9 G722/8000

a=ptime:20

a=rtpmap:101 telephone-event/8000

a=fmtp:101 0-15

出力/結果

SIP/2.0 200 OK

.

Content-Type: application/sdp

v=0

o=CiscoSystemsCCM-SIP 2000 1 IN IP4 172.18.197.22

e=nobody@cisco.com

s=SIP Call

c=IN IP4 172.18.197.29

t=0 0

m=audio 17774 RTP/AVP 9 101

a=rtpmap:9 G722/8000

a=ptime:20

a=rtpmap:101 telephone-event/8000

a=fmtp:101 0-15

removeLine

sdp:removeLine(start-of-line, line-contains)

このメソッドは、「sdp」内で「start-of-line」で開始し、なおかつ「line-contains」パラメータが指定されていればその行内に「line-contains」も持つ最初の行を探します。一致した行は、sdp から削除されます。

例：「a=rtpmap」と「G729」の両方を含む行を SDP から削除します。

スクリプト

M = {}

function M.inbound_INVITE(msg)

local sdp = msg:getSdp()

if sdp

then

sdp = sdp:removeLine("a=rtpmap:", "G729")

msg:setSdp(sdp)

end

end

return M

メッセージ

INVITE sip:901@rawlings.cisco.com:5080 SIP/2.0

.

Content-Type: application/sdp

v=0

o=CiscoSystemsCCM-SIP 2000 1 IN IP4 172.18.197.22

s=SIP Call

c=IN IP4 172.18.197.29

t=0 0

m=audio 25328 RTP/AVP 9 0 8 18 101

a=rtpmap:9 G722/8000

a=ptime:20

a=rtpmap:0 PCMU/8000

a=ptime:20

a=rtpmap:8 PCMA/8000

a=ptime:20

a=rtpmap:18 G729/8000

a=ptime:20

a=fmtp:18 annexb=no

a=rtpmap:101 telephone-event/8000

a=fmtp:101 0-15

出力/結果

INVITE sip:901@rawlings.cisco.com:5080 SIP/2.0

.

Content-Type: application/sdp

v=0

o=CiscoSystemsCCM-SIP 2000 1 IN IP4 172.18.197.22

s=SIP Call

c=IN IP4 172.18.197.29

t=0 0

m=audio 25328 RTP/AVP 9 0 8 18 101

a=rtpmap:9 G722/8000

a=ptime:20

a=rtpmap:0 PCMU/8000

a=ptime:20

a=rtpmap:8 PCMA/8000

a=ptime:20

a=ptime:20

a=fmtp:18 annexb=no

a=rtpmap:101 telephone-event/8000

a=fmtp:101 0-15

メディア記述レベルの API

SDP メディアレベルでの SDP の取得と操作に使用される API は次のとおりです。

SDP の例

次の SDP の例では、セッションレベルの行は緑色で示し、メディアレベルの行を青色で示しています。

v=0\r\n

o=CiscoSystemsCCM-SIP 2000 3 IN IP4 172.18.195.96\r\n

s=SIP Call\r\n

c=IN IP4 172.18.195.126\r\n

t=0 0\r\n

[1] m=audio 18884 RTP/AVP 9 18 101\r\n

a=rtpmap:9 G722/8000\r\n

a=ptime:20\r\n

a=rtpmap:18 G729/8000\r\n

a=ptime:20\r\n

a=fmtp:18 annexb=no\r\n

a=rtpmap:101 telephone-event/8000\r\n

a=fmtp:101 0-1\r\n

[2] m=video...

上の SDP の例では、メディアレベルのインデックスは青色になっています。メディアレベル [1] は、音声メディアの記述です。メディアレベル [2] は、ビデオメディアの記述です（全体は示していません）。

インデックスはすべて、1 から始まるインデックスです。したがって、最初のメディア記述はインデックス 1、2 つ目はインデックス 2 となります。以下、同様です。

メディア記述レベルでは、次の API が使用できます。

• 「getMediaDescription(media-level)」

• 「getMediaDescription(media-contains)」

• 「modifyMediaDescription(media-level, media-description)」

• 「modifyMediaDescription(media-contains, media-description)」

• 「addMediaDescription(media-description)」

• 「insertMediaDescription(media-level, media-description)」

• 「removeMediaDescription(media-level)」

• 「removeMediaDescription(media-contains)」

パラメータの説明

パラメータ	説明
sdp	sdp オブジェクトは、SDP の入った文字列です。制御文字（「\r」、「\n」など）もすべて含みます。
media-level	media-level パラメータは、SDP 内のメディア記述を参照するために使用されるインデックスです。インデックスは、1 から始まります。SDP 内の最初のメディア記述は、メディアレベル 1、2 つ目はメディアレベル 2 です。以下、同様です。
media-contains	media-contains パラメータは、m 行内で何か（例：メディアタイプ）を探すために使用される文字列です。たとえば、audio、video、message などを使用して、メディア記述内の m 行が media-contains 値に完全に一致する最初のメディア記述を取得したり、修正したり、削除したりできます。
media-description	media-description パラメータは、複数の行と必要な埋め込み制御文字（「\r」および「\n」）を含む完全なメディア記述が入った文字列です。最後の行は「\r\n」で終了させることを強く推奨します。これらの API が行う内容は純粋なテキスト操作で、テキストに対して強制される形式に関するルールは一切ありません。実際、実装によっては、各行の末尾に「\r」が含まれない場合もあります。これを純粋なテキストとして扱うことにより、いずれのケースも処理することができ、2 つのスタイル間での変換さえも簡単に行えるという、必要性のある柔軟性が得られます（たとえば、「\r\n」を「\n」に変換したり、その逆を行ったりすることはごく普通のことです）。次の文字列は、完全なメディア記述の一例です。 "m=audio 18884 RTP/AVP 9\r\na=rtpmap:9 G722/8000\r\n"

以降で、各メディア関連 API の詳細について説明します。

（注）インデックス（つまり media-level）は、すべて 1 から始まるインデックスです。

getMediaDescription(media-level)

getMediaDescription(media-level) returns media-description

この API は、指定したメディアレベルの特定のメディア記述を取得するのに使用します。

例：最初のメディア記述を取得して、ローカル変数に値として格納します。

スクリプト

M = {}

function M.outbound_INVITE(msg)

local sdp = msg:getSdp()

if sdp

then

local m1 = sdp:getMediaDescription(1)

end

end

return M

メッセージ

v=0\r\n

o=CiscoSystemsCCM-SIP 2000 3 IN IP4 172.18.195.96\r\n

s=SIP Call\r\n

c=IN IP4 172.18.195.126\r\n

t=0 0\r\n

[1] m=audio 18884 RTP/AVP 9 18 101\r\n

a=rtpmap:9 G722/8000\r\n

a=ptime:20\r\n

a=rtpmap:18 G729/8000\r\n

a=ptime:20\r\n

a=fmtp:18 annexb=no\r\n

a=rtpmap:101 telephone-event/8000\r\n

a=fmtp:101 0-1\r\n

[2] m=video...

出力/結果

Local variable m1 is set to a string

m=audio 18884 RTP/AVP 9 18 101\r\n

a=rtpmap:9 G722/8000\r\n

a=ptime:20\r\n

a=rtpmap:18 G729/8000\r\n

a=ptime:20\r\n

a=fmtp:18 annexb=no\r\n

a=rtpmap:101 telephone-event/8000\r\n

a=fmtp:101 0-1\r\n

getMediaDescription(media-contains)

getMediaDescription(media-contains) returns media-description

この API は、m 行に media-contains と完全に一致する部分を持つ特定のメディア記述を取得するのに使用します。

（注）複数の m 行が一致する場合は、media-description と一致する最初のメディア記述だけが返されます。

例：m 行に「audio」というテキストを含む最初のメディア記述を取得して、ローカル変数に値として格納します。

スクリプト

M = {}

function M.outbound_INVITE(msg)

local sdp = msg:getSdp()

if sdp

then

local audio = sdp:getMediaDescription("audio")

end

end

return M

メッセージ

v=0\r\n

o=CiscoSystemsCCM-SIP 2000 3 IN IP4 172.18.195.96\r\n

s=SIP Call\r\n

c=IN IP4 172.18.195.126\r\n

t=0 0\r\n

[1] m=audio 18884 RTP/AVP 9 18 101\r\n

a=rtpmap:9 G722/8000\r\n

a=ptime:20\r\n

a=rtpmap:18 G729/8000\r\n

a=ptime:20\r\n

a=fmtp:18 annexb=no\r\n

a=rtpmap:101 telephone-event/8000\r\n

a=fmtp:101 0-1\r\n

[2] m=video...

出力/結果

Local variable audio is set to a string

m=audio 18884 RTP/AVP 9 18 101\r\n

a=rtpmap:9 G722/8000\r\n

a=ptime:20\r\n

a=rtpmap:18 G729/8000\r\n

a=ptime:20\r\n

a=fmtp:18 annexb=no\r\n

a=rtpmap:101 telephone-event/8000\r\n

a=fmtp:101 0-1\r\n

modifyMediaDescription(media-level, media-description)

modifyMediaDescription(media-level, media-description)

この API は、指定したメディアレベルの特定のメディア記述を修正するのに使用します。

例：「a=ptime:20\r\n」を含む業を音声メディア記述から削除します。

スクリプト

M = {}

function M.outbound_INVITE(msg)

local sdp = msg:getSdp()

if sdp

then

local m1 = sdp:getMediaDescription(1)

if m1

then

m1 = m1:gsub("a=ptime:20\r\n", "")

sdp = sdp:modifyMediaDescription(1, m1)

msg:setSdp(sdp)

end

end

end

return M

正規化前のメッセージ

v=0\r\n

o=CiscoSystemsCCM-SIP 2000 3 IN IP4 172.18.195.96\r\n

s=SIP Call\r\n

c=IN IP4 172.18.195.126\r\n

t=0 0\r\n

[1] m=audio 18884 RTP/AVP 9 18 101\r\n

a=rtpmap:9 G722/8000\r\n

a=ptime:20\r\n

a=rtpmap:18 G729/8000\r\n

a=ptime:20\r\n

a=fmtp:18 annexb=no\r\n

a=rtpmap:101 telephone-event/8000\r\n

a=fmtp:101 0-1\r\n

[2] m=video...

正規化後のメッセージ

After normalization, the SDP would contain:

v=0\r\n

o=CiscoSystemsCCM-SIP 2000 3 IN IP4 172.18.195.96\r\n

s=SIP Call\r\n

c=IN IP4 172.18.195.126\r\n

t=0 0\r\n

[1] m=audio 18884 RTP/AVP 9 18 101\r\n

a=rtpmap:9 G722/8000\r\n

a=rtpmap:18 G729/8000\r\n

a=fmtp:18 annexb=no\r\n

a=rtpmap:101 telephone-event/8000\r\n

a=fmtp:101 0-1\r\n

[2] m=video...

modifyMediaDescription(media-contains, media-description)

modifyMediaDescription(media-contains, media-description)

この API は、m 行に media-contains と完全に一致する部分を持つ特定のメディア記述を修正するのに使用します。複数の m 行が一致する場合は、media-description と一致する最初のメディア記述だけが修正されます。

例：「a=ptime:20\r\n」を含む業を音声メディア記述から削除します。

スクリプト

M = {}

function M.outbound_INVITE(msg)

local sdp = msg:getSdp()

if sdp

then

local audio = sdp:getMediaDescription("audio")

if audio

then

audio = audio:gsub("a=ptime:20\r\n", "")

sdp = sdp:modifyMediaDescription("audio", audio)

msg:setSdp(sdp)

end

end

end

return M

正規化前のメッセージ

v=0\r\n

o=CiscoSystemsCCM-SIP 2000 3 IN IP4 172.18.195.96\r\n

s=SIP Call\r\n

c=IN IP4 172.18.195.126\r\n

t=0 0\r\n

[1] m=audio 18884 RTP/AVP 9 18 101\r\n

a=rtpmap:9 G722/8000\r\n

a=ptime:20\r\n

a=rtpmap:18 G729/8000\r\n

a=ptime:20\r\n

a=fmtp:18 annexb=no\r\n

a=rtpmap:101 telephone-event/8000\r\n

a=fmtp:101 0-1\r\n

[2] m=video...

正規化後のメッセージ

v=0\r\n

o=CiscoSystemsCCM-SIP 2000 3 IN IP4 172.18.195.96\r\n

s=SIP Call\r\n

c=IN IP4 172.18.195.126\r\n

t=0 0\r\n

[1] m=audio 18884 RTP/AVP 9 18 101\r\n

a=rtpmap:9 G722/8000\r\n

a=ptime:20\r\n

a=rtpmap:18 G729/8000\r\n

a=ptime:20\r\n

a=fmtp:18 annexb=no\r\n

a=rtpmap:101 telephone-event/8000\r\n

a=fmtp:101 0-1\r\n

[2] m=video...

addMediaDescription(media-description)

addMediaDescription(media-description)

この API は、1 つのメディア記述を最後のメディア記述として追加するのに使用します。

例：

このスクリプトは、着信 INVITE からビデオメディア記述を削除して、保存します。このスクリプトでは、ビデオメディア記述が 2 つ目のメディア記述であることを前提としています。対応する発信応答については、このスクリプトは、格納されているビデオメディア記述を取得し、ポートを 0 に設定し、そのメディア記述を発信 SDP に追加します。

スクリプト

M = {}

function M.inbound_INVITE(msg)

local sdp = msg:getSdp()

if sdp

then

local video = sdp:getMediaDescription(2)

if video

then

--remove the video media description

sdp = sdp:removeMediaDescription(2)

--store video media description

local context = msg:getContext()

context["video"] = video

msg:setSdp(sdp)

end

end

end

function M.outbound_ANY_INVITE(msg)

local sdp = msg:getSdp()

--assume other side is expecting video before audio when there is

--a video m-line in the SDP

if sdp

then

local context = msg:getContext()

local video = context["video"]

if video

then

--set port to zero in SDP answer

video = video:gsub("video %d* RTP", "video 0 RTP")

sdp = sdp:addMediaDescription(video)

msg:setSdp(sdp)

end

end

end

return M

正規化前のメッセージ

INVITE SDP . . .

v=0\r\n

o=- 2000 3 IN IP4 10.10.10.100\r\n

s=SIP Call\r\n

c=IN IP4 10.10.10.100\r\n

t=0 0\r\n

[1] m=audio 18884 RTP/AVP 9 18 101\r\n

a=rtpmap:9 G722/8000\r\n

a=ptime:20\r\n

a=rtpmap:18 G729/8000\r\n

a=ptime:20\r\n

a=fmtp:18 annexb=no\r\n

a=rtpmap:101 telephone-event/8000\r\n

a=fmtp:101 0-1\r\n

[2] m=video 32068 RTP/AVP 112 113 114\r\n

b=TIAS:4000000\r\n

a=rtpmap:112 H264/90000\r\n

a=fmtp:112 profile-level-id=4D8028;packetization-mode=1;max-mbps=243000;max-fs=8100\r\n

a=rtpmap:113 H264/90000\r\n

a=fmtp:113 profile-level-id=42400D;packetization-mode=1;max-mbps=11880;max-fs=396\r\n

a=rtpmap:114 H264/90000\r\n

a=fmtp:114 profile-level-id=42400D;packetization-mode=0;max-mbps=11880;max-fs=396\r\n

a=sendrecv\r\n

\r\n

200 Ok SDP . . .

v=0\r\n

o=CiscoSystemsCCM-SIP 2000 3 IN IP4 10.10.10.1\r\n

s=SIP Call\r\n

c=IN IP4 10.10.10.200\r\n

t=0 0\r\n

[1] m=audio 16007 RTP/AVP 9 18 101\r\n

a=rtpmap:9 G722/8000\r\n

a=ptime:20\r\n

a=rtpmap:101 telephone-event/8000\r\n

a=fmtp:101 0-1\r\n

\r\n

正規化後のメッセージ

INVITE SDP . . .

v=0\r\n

o=- 2000 3 IN IP4 10.10.10.100\r\n

s=SIP Call\r\n

c=IN IP4 10.10.10.100\r\n

t=0 0\r\n

[1] m=audio 18884 RTP/AVP 9 18 101\r\n

a=rtpmap:9 G722/8000\r\n

a=ptime:20\r\n

a=rtpmap:18 G729/8000\r\n

a=ptime:20\r\n

a=fmtp:18 annexb=no\r\n

a=rtpmap:101 telephone-event/8000\r\n

a=fmtp:101 0-1\r\n

\r\n

200 Ok SDP . . .

v=0\r\n

o=CiscoSystemsCCM-SIP 2000 3 IN IP4 10.10.10.1\r\n

s=SIP Call\r\n

c=IN IP4 10.10.10.200\r\n

t=0 0\r\n

[1] m=audio 16007 RTP/AVP 9 18 101\r\n

a=rtpmap:9 G722/8000\r\n

a=ptime:20\r\n

a=rtpmap:101 telephone-event/8000\r\n

a=fmtp:101 0-1\r\n

[2] m=video 0 RTP/AVP 112 113 114\r\n

b=TIAS:4000000\r\n

a=rtpmap:112 H264/90000\r\n

a=fmtp:112 profile-level-id=4D8028;packetization-mode=1;max-mbps=243000;max-fs=8100\r\n

a=rtpmap:113 H264/90000\r\n

a=fmtp:113 profile-level-id=42400D;packetization-mode=1;max-mbps=11880;max-fs=396\r\n

a=rtpmap:114 H264/90000\r\n

a=fmtp:114 profile-level-id=42400D;packetization-mode=0;max-mbps=11880;max-fs=396\r\n

a=sendrecv\r\n

\r\n

insertMediaDescription(media-level, media-description)

insertMediaDescription(media-level, media-description)

この API は、指定したメディアレベルのメディア記述を追加するのに使用します。

例：メッセージメディア記述を、それが SDP 内の最初のメディア記述になるように挿入します。

スクリプト

M = {}

function M.outbound_INVITE(msg)

local sdp = msg:getSdp()

if sdp

then

local message = "m=message 1234 sip:alice@10.10.10.100\r\n"

sdp = sdp:insertMediaDescription(1, message)

msg:setSdp(sdp)

end

end

return M

正規化前のメッセージ

INVITE SDP . . .

v=0\r\n

o=- 2000 3 IN IP4 10.10.10.100\r\n

s=SIP Call\r\n

c=IN IP4 10.10.10.100\r\n

t=0 0\r\n

[1] m=audio 18884 RTP/AVP 9 18 101\r\n

a=rtpmap:9 G722/8000\r\n

a=ptime:20\r\n

a=rtpmap:18 G729/8000\r\n

a=ptime:20\r\n

a=fmtp:18 annexb=no\r\n

a=rtpmap:101 telephone-event/8000\r\n

a=fmtp:101 0-1\r\n

正規化後のメッセージ

INVITE SDP . . .

v=0\r\n

o=- 2000 3 IN IP4 10.10.10.100\r\n

s=SIP Call\r\n

c=IN IP4 10.10.10.100\r\n

t=0 0\r\n

[1] m=message 1234 sip:alice@10.10.10.100\r\n

[2] m=audio 18884 RTP/AVP 9 18 101\r\n

a=rtpmap:9 G722/8000\r\n

a=ptime:20\r\n

a=rtpmap:18 G729/8000\r\n

a=ptime:20\r\n

a=fmtp:18 annexb=no\r\n

a=rtpmap:101 telephone-event/8000\r\n

a=fmtp:101 0-1\r\n

removeMediaDescription(media-level)

removeMediaDescription(media-level)

この API は、指定したメディアレベルのメディア記述を削除するのに使用します。

例：

「addMediaDescription(media-description)」に示されている例を参照してください。この例は、removeMediaDescription も使用しています。

removeMediaDescription(media-contains)

removeMediaDescription(media-contains)

この API は、m 行に media-contains と完全に一致する部分を持つ特定のメディア記述を削除するのに使用します。

（注）複数の m 行が一致する場合は、media-description と一致する最初のメディア記述だけが削除されます。

例：

このスクリプトは、着信 INVITE からビデオメディア記述を削除して、保存します。対応する発信応答については、このスクリプトは、格納されているビデオメディア記述を取得し、ポートを 0 に設定し、そのメディア記述を発信 SDP に追加します。

スクリプト

M = {}

function M.inbound_INVITE(msg)

local sdp = msg:getSdp()

if sdp

then

local video = sdp:getMediaDescription("video")

if video

then

--remove the video media description

sdp = sdp:removeMediaDescription("video")

--store video media description

local context = msg:getContext()

context["video"] = video

msg:setSdp(sdp)

end

end

end

function M.outbound_ANY_INVITE(msg)

local sdp = msg:getSdp()

--assume other side is expecting video before audio when there is

--a video m-line in the SDP

if sdp

then

local context = msg:getContext()

local video = context["video"]

if video

then

--set port to zero in SDP answer

video = video:gsub("video %d* RTP", "video 0 RTP")

sdp = sdp:addMediaDescription(video)

msg:setSdp(sdp)

end

end

end

return M

正規化前のメッセージ

INVITE SDP . . .

v=0\r\n

o=- 2000 3 IN IP4 10.10.10.100\r\n

s=SIP Call\r\n

c=IN IP4 10.10.10.100\r\n

t=0 0\r\n

[1] m=audio 18884 RTP/AVP 9 18 101\r\n

a=rtpmap:9 G722/8000\r\n

a=ptime:20\r\n

a=rtpmap:18 G729/8000\r\n

a=ptime:20\r\n

a=fmtp:18 annexb=no\r\n

a=rtpmap:101 telephone-event/8000\r\n

a=fmtp:101 0-1\r\n

[2] m=video 32068 RTP/AVP 112 113 114\r\n

b=TIAS:4000000\r\n

a=rtpmap:112 H264/90000\r\n

a=fmtp:112 profile-level-id=4D8028;packetization-mode=1;max-mbps=243000;max-fs=8100\r\n

a=rtpmap:113 H264/90000\r\n

a=fmtp:113 profile-level-id=42400D;packetization-mode=1;max-mbps=11880;max-fs=396\r\n

a=rtpmap:114 H264/90000\r\n

a=fmtp:114 profile-level-id=42400D;packetization-mode=0;max-mbps=11880;max-fs=396\r\n

a=sendrecv\r\n

\r\n

200 Ok SDP . . .

v=0\r\n

o=CiscoSystemsCCM-SIP 2000 3 IN IP4 10.10.10.1\r\n

s=SIP Call\r\n

c=IN IP4 10.10.10.200\r\n

t=0 0\r\n

[1] m=audio 16007 RTP/AVP 9 18 101\r\n

a=rtpmap:9 G722/8000\r\n

a=ptime:20\r\n

a=rtpmap:101 telephone-event/8000\r\n

a=fmtp:101 0-1\r\n

\r\n

正規化後のメッセージ

INVITE SDP . . .

v=0\r\n

o=- 2000 3 IN IP4 10.10.10.100\r\n

s=SIP Call\r\n

c=IN IP4 10.10.10.100\r\n

t=0 0\r\n

[1] m=audio 18884 RTP/AVP 9 18 101\r\n

a=rtpmap:9 G722/8000\r\n

a=ptime:20\r\n

a=rtpmap:18 G729/8000\r\n

a=ptime:20\r\n

a=fmtp:18 annexb=no\r\n

a=rtpmap:101 telephone-event/8000\r\n

a=fmtp:101 0-1\r\n

\r\n

200 Ok SDP . . .

v=0\r\n

o=CiscoSystemsCCM-SIP 2000 3 IN IP4 10.10.10.1\r\n

s=SIP Call\r\n

c=IN IP4 10.10.10.200\r\n

t=0 0\r\n

[1] m=audio 16007 RTP/AVP 9 18 101\r\n

a=rtpmap:9 G722/8000\r\n

a=ptime:20\r\n

a=rtpmap:101 telephone-event/8000\r\n

a=fmtp:101 0-1\r\n

[2] m=video 0 RTP/AVP 112 113 114\r\n

b=TIAS:4000000\r\n

a=rtpmap:112 H264/90000\r\n

a=fmtp:112 profile-level-id=4D8028;packetization-mode=1;max-mbps=243000;max-fs=8100\r\n

a=rtpmap:113 H264/90000\r\n

a=fmtp:113 profile-level-id=42400D;packetization-mode=1;max-mbps=11880;max-fs=396\r\n

a=rtpmap:114 H264/90000\r\n

a=fmtp:114 profile-level-id=42400D;packetization-mode=0;max-mbps=11880;max-fs=396\r\n

a=sendrecv\r\n

\r\n

このドキュメントは役に立ちましたか?

Feedback

フィードバック

シスコに問い合わせ

サポートケースをオープン
(シスコサービス契約が必要です。)