add_notes_voice_pptx2 プログラム仕様

add_notes_voice_pptx2.build_dialogue_voice_map(tktts_obj, tts_engine, voices_override, speakers)

対話モード用の voice_map を構築する。

話者名とVOICE_MAPSのキーとの照合は casefold() で行い、大文字小文字の違いを 許容する。--voices による明示指定(「話者名=ボイス」または検出順の位置指定 「ボイス1;ボイス2;...」)がある場合はそちらを優先する。

add_notes_voice_pptx2.close_powerpoint(pres, ppt)
add_notes_voice_pptx2.collect_speakers(dialogue_map)

dialogue_map全体から、登場する話者名を初出順・重複無しで収集する。

話者名の同一判定は casefold() による大文字小文字の違いのみ吸収する (表記ゆれの吸収まではしない)。返り値は初出時点の表記のまま。

add_notes_voice_pptx2.extract_dialogue_from_pptx(pptx_path, monologue)

ノートを抽出する。各スライドの失敗は警告し、後続を処理する。

add_notes_voice_pptx2.extract_narration_text(notes_text)

Return (text inside ((...)), True/False) を返す。

デリミタが同一行/複数行のどちらでも対応する。((...)) が見つからない場合は (ノート全文, False) を返す。これは異常な状態だが、互換性のための緩和措置として 呼び出し側で「全文をそのまま読み上げる」フォールバックに用いる。

add_notes_voice_pptx2.generate_audio_files_tktts(dialogue_map, voice_map, args, tktts)

tktts のインターフェースを使用して、dialogue_map から音声ファイルを生成する。

add_notes_voice_pptx2.get_notes_text(slide)

ノート本文だけを取得する。

add_notes_voice_pptx2.initialize()

成功した音声をリンクし、失敗したスライドは警告して続ける。

add_notes_voice_pptx2.main()
add_notes_voice_pptx2.parse_dialogue_lines(narration_text)

カンマのない継続行は直前の話者の発言に連結する。

add_notes_voice_pptx2.terminate(pause=True)

プログラムを終了する