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.link_audio_autoplay(source_pptx_path, audio_tasks, output_pptx)
成功した音声をリンクし、失敗したスライドは警告して続ける。
- add_notes_voice_pptx2.main()
- add_notes_voice_pptx2.parse_dialogue_lines(narration_text)
カンマのない継続行は直前の話者の発言に連結する。
- add_notes_voice_pptx2.terminate(pause=True)
プログラムを終了する