インタフェース仕様
関数の一覧
以下は、構成要素の種類別に、実装が必須の関数と実装が任意のオプション関数(表内で「オプ」と表記)を一覧にしたものです。
関数名 | 構成要素の種類 | ||||
---|---|---|---|---|---|
入力センス | 出力制御 | 入出力 | ビデオ解析 | 音声解析 | |
ステーションが呼び出す Python のクラス内の関数 | |||||
__init__ | 必須 | 必須 | 必須 | 必須 | 必須 |
sense | オプ | オプ | |||
control | オプ | オプ | オプ | オプ | |
new_video_frame | 必須 | ||||
new_audio_frame | 必須 | ||||
terminate | オプ | オプ | オプ | オプ | オプ |
__del__ | オプ | オプ | オプ | オプ | オプ |
Python プログラムが呼び出すプラットフォーム上の関数 | |||||
set_value | 必須 | オプ | 必須 | オプ | オプ |
get_last_value | オプ | オプ | オプ | ||
set_video_frame | オプ | ||||
snapshot_frame | オプ | ||||
set_audio_frame | オプ | ||||
start_record_source | オプ | オプ | |||
stop_record_source | オプ | オプ | |||
start_record_analysis | オプ | オプ | |||
stop_record_analysis | オプ | オプ | |||
kill_self | オプ | オプ | オプ | オプ | オプ |
オプ | オプ | オプ | オプ | オプ | |
Python プログラムが呼び出すプラットフォーム上のユーティリティー関数 | |||||
speak_on_station | オプ | オプ | オプ | オプ | オプ |
speak_in_browser | オプ | オプ | オプ | オプ | オプ |
sound_on_station | オプ | オプ | オプ | オプ | オプ |
sound_in_browser | オプ | オプ | オプ | オプ | オプ |
ステーションが呼び出す Python のクラス内のイベント関数 | |||||
share_changed | オプ | オプ | オプ | オプ | オプ |
setting_changed | オプ | ||||
ui_event | オプ |
アプリの動作制限
Remotte では、ステーションの過負荷によるシステムダウンを回避する目的で、PC 環境(CPU とメモリーの使用率)およびステーションとブラウザ間の通信状態(遅延時間)に応じて実行中のアプリケーションの動作を制限する場合があります。この制限には、以下が含まれます。
1)ステーションからブラウザへ最新値を伝える配信の間引き
2)解析系の構成要素における解析処理の間引き
3)メディアデータの配信及び記録の間引き
上記1)については、各構成要素の Python プログラムが、プラットフォームに対して最新値を通知するための関数 set_value( ) のオプション引数にてデータの重要度(レベルオプション)を伝えることで、以下の様に制御できます。「警告負荷」とは、概ね80%から90%のリソースが、「高負荷」とは概ね90%以上のリソースが使われている状態をいいます。また、通信状態については、ステーションとブラウザ間で2秒超の遅延がある場合に制限の対象になります。
レベル オプション |
PC 環境の状態 | ||||
---|---|---|---|---|---|
低負荷 | 警告負荷 | 高負荷 | |||
high | ○ | ○ | ○ | ||
normal | ○ | △ | × | ||
low | ○ | × | × |
○ | 配信される |
△ | 間引きされる |
× | 配信されない |