開発者用 SIP 透過性および正規化ガイド
- Updated:
- 2017年6月14日
章のタイトル： トレース API
トレース API
スクリプトのトレーシングにより、スクリプト作成者がスクリプト内からトレースを生成することが可能になります。これは、スクリプトのデバッグだけに使用してください。スクリプトを稼動させ始めるときには、無効にする必要があります。スクリプトのトレーシングを有効にする方法は 2 通りあります。
1.
設定を使用する：SIP トランクに関連した [Script Trace] チェックボックスを参照してください。
2. スクリプトを使用する： trace.enable() API を参照してください。
次の表に、上述の 2 つの設定のすべての組み合わせにおいて、トレースがスクリプトによって生成されるかどうかを示します。
|
|
|
|
|---|---|---|
trace.format
この関数は、フォーマット文字列と一連のパラメータを受け取って、スクリプトに関連付けられているトランクのトレーシングが有効になっており、スクリプトが trace.enable() によってトレーシングを有効にしていた場合に、パラメータをフォーマット文字列に挿入し、その出力を SDI トレース ファイルに書き出します。
trace.enable
この関数は、スクリプトがトレーシングをローカルに有効にすることを可能にします。
（注） トレーシングは、そのスクリプトを使用する SIP トランクの設定でも有効になっている必要があります。
前述の例、 「trace.format」 を参照してください。
trace.disable
この関数は、スクリプトがトレーシングをローカルに無効にすることを可能にします。
（注） 関連付けられているトランクのスクリプト トレース設定フラグがオンになっている場合は、たとえここで無効にしても、Trace.output によってスクリプト トレースが生成されます。
trace.enabled
スクリプトのこのインスタンスに関連付けられているデバイス上でスクリプト トレーシングが有効になっているか、またはスクリプト自身でトレーシングを有効にしていた場合に、true が返されます。トレーシングが有効になっていない場合は、false が返されます。
フィードバック