설명
실행이 이 노드에 도달하면 브라우저에서 오디오를 재생합니다. 오디오는 audio 입력(AUDIO 타입)을 통해 제공하거나 audio_path 문자열 입력에 파일 경로를 지정하여 제공할 수 있습니다(audio 입력이 연결되지 않은 경우 사용). 이 노드는 세 가지 재생 모드를 제공합니다: always(모든 실행 시 재생), on_empty_queue(실행 대기열이 끝날 때만 재생), on_change(오디오 콘텐츠가 변경될 때만 재생). duration 매개변수는 재생 길이를 제한합니다. 0.0으로 설정하면 전체 오디오 파일을 재생합니다.
입력
| 이름 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
any_input | ANYTYPE | 아니요 | — | 모든 유형의 passthrough 입력입니다. 기존 연결을 끊지 않고 이 노드를 워크플로에 삽입할 수 있습니다. |
audio | AUDIO | 아니요 | — | 다른 노드(예: VAE 디코드 출력)의 오디오 데이터입니다. 연결되면 재생할 오디오 소스입니다. |
audio_path | STRING | 예 | "" | 오디오 파일의 파일 경로입니다. audio 입력이 연결되지 않은 경우에만 사용됩니다. audio 입력을 사용하는 경우 비워 둡니다. |
mode | COMBO | 예 | "always" | 재생 트리거 모드입니다. 옵션: "always" – 모든 실행 시 재생, "on_empty_queue" – 실행 대기열이 끝날 때만 재생, "on_change" – 오디오 콘텐츠(audio 입력 또는 audio_path)가 변경될 때만 재생. |
volume | 실수 | 예 | 0.5 | 재생 볼륨입니다. 0.0(무음)부터 1.0(최대 볼륨)까지입니다. 단계 크기 0.01. |
duration | 실수 | 예 | 5.0 | 재생할 시간(초)입니다. 0.0으로 설정하면 전체 오디오를 재생합니다. 범위: 0.0 ~ 300.0, 단계 크기 0.1. |
출력
| 타입 | 설명 |
|---|---|
| ANYTYPE | any_input 입력의 값을 변경하지 않고 전달하여 워크플로 연속성을 유지합니다. any_input이 연결되지 않은 경우 출력은 None이 됩니다. |
사용 참고 사항
- 오디오 소스 우선순위:
audio입력이 연결되면audio_path보다 우선합니다. 둘 다 제공된 경우audio입력이 사용됩니다. - 모드 동작:
always– 테스트 또는 연속 재생에 적합합니다.on_empty_queue– 배치 생성 완료 후 알림 사운드를 재생하는 데 유용합니다.on_change– 실제 오디오 데이터(또는audio_path사용 시 파일 경로)가 이전 실행과 다를 때만 재생합니다. 동일한 오디오로 노드가 여러 번 실행될 때 반복 재생을 방지합니다.
- Duration:
0.0값은 전체 오디오 클립을 재생합니다. 그렇지 않으면 지정된 시간(초) 후에 재생이 중단됩니다(최대 300초). - Volume: 볼륨은 오디오에 적용되는 직선 게인입니다.
1.0이상의 값은 허용되지 않습니다. 증폭이 필요한 경우 다른 곳에서 오디오를 사전 처리하십시오. - 출력:
any_inputpassthrough를 사용하면 데이터 흐름에 영향을 주지 않고 이 노드를 연결할 수 있습니다(예: 오디오로 모니터링하려는 출력이 있는 노드에 병렬로 연결). - 브라우저 환경: 오디오는 브라우저의 오디오 시스템을 통해 재생됩니다. 브라우저에서 오디오 재생이 활성화되어 있고 자동 재생 정책이 충족되는지 확인하십시오(이 노드는 첫 실행 시 사용자 동작이 필요할 수 있음).
댓글
GitHub로 로그인하고 토론에 참여하세요.