ボイスラインツール

VALORANTのエージェントボイスラインを検索・一覧取得します。

search_voicelines

ボイスラインをエージェント・カテゴリ・テキストで検索します。

パラメーター

名前	型	デフォルト	説明
agent	string	""	エージェント名（日本語・英語どちらでも可）
category	string	""	カテゴリ（get_voiceline_categories で確認）
keyword	string	""	書き起こしテキストで絞り込み
version	int	2	ボイスラインデータのバージョン
limit	int	20	取得件数
offset	int	0	オフセット

レスポンス

{
  "total": 84,
  "limit": 20,
  "offset": 0,
  "results": [
    {
      "agent_name": "ジェット",
      "agent_name_en": "Jett",
      "category": "kill",
      "text": "消えろ。",
      "audio_url": "https://valo.town/audio-tss/jett/kill_001.ogg",
      "duration_ms": 1200
    }
  ]
}

使用例

# ジェットのボイスライン全件
search_voicelines(agent="ジェット")

# キルボイス全エージェント
search_voicelines(category="kill")

# テキスト検索
search_voicelines(keyword="消えろ")

# エージェント＋カテゴリ絞り込み
search_voicelines(agent="Reyna", category="round_start")

audio_url

返される audio_url は https://valo.town/ ドメインでホストされた音声ファイルです。外部ドメインのURLは返されません。

---

get_voiceline_categories

ボイスラインのカテゴリ一覧を取得します。

レスポンス

["kill", "round_start", "round_end", "tactical", "low_health", "spike_plant", "spike_defuse", "ability_use"]

使用例

get_voiceline_categories()

---

get_voiceline_agents

ボイスラインデータに収録されているエージェントの一覧（日本語・英語名）を取得します。

レスポンス

[
  { "name_jp": "ジェット",  "name_en": "Jett"  },
  { "name_jp": "レイナ",   "name_en": "Reyna" },
  { "name_jp": "オーメン", "name_en": "Omen"  }
]

使用例

get_voiceline_agents()

情報

search_voicelines の agent パラメーターには日本語・英語どちらの表記でも指定できます。このツールで正確な名前を確認してから検索すると確実です。