한 장의 그림으로 이해하기

그림 크게 보기 ↗ (새 탭)
이미지·영상·음성 · 판정 관망
그림을 글로 풀면
표식과 반환 설정
Cloud TTS의 대본 표식만으로 시점 정보가 기본 반환되지는 않습니다.
- 대상
- 음성과 화면의 전환을 맞추는 제작자
- 무엇이 바뀜
- mark와 SSML_MARK 반환 설정을 함께 확인합니다.
- 왜 중요한가
- 대본 위치와 오디오 시각을 연결하는 조건이 다릅니다.
- 지금 할 일
- 응답의 표식 이름과 초 단위 시점을 대조하세요.
- 한계·미확인
- 개념 비유. API 합성·청취·동기화 시험 없음.
- 확인일
- 2026-10-16
화면 전환의 기준을 대본에 남기기
가상의 음성 안내에서 특정 문장에 맞춰 화면을 바꾸려는 상황입니다. 대본에 깃발을 꽂는 그림은 원하는 위치를 표시하는 단계입니다. 위치를 지정한 기록과 실제 음성에서 그 위치가 나타나는 시각은 별개이므로, 화면 전환표에는 응답으로 받은 시점 정보를 연결하는 절차가 필요합니다.
표식을 넣은 뒤 반환 조건을 확인하기
Google Cloud TTS 문서는 SSML의 mark 태그로 위치를 지정하고 TimepointType을 SSML_MARK로 설정해야 시점을 돌려준다고 안내합니다. 기본값에서는 시점 정보가 반환되지 않습니다. 연결된 v1beta1 text.synthesize 참조의 요청 필드는 enableTimePointing이며, 반환 timepoints에는 markName과 timeSeconds가 있습니다. timeSeconds는 생성 음성 시작부터의 초 단위 간격입니다.
응답과 재생을 따로 검토하기
AINOW는 대본의 표식 이름, 반환 설정, 응답의 같은 이름과 시간값을 차례로 대조하도록 제안합니다. 시간값을 받았다는 사실만으로 실제 화면과 음성이 맞는다고 판단하지 말고 재생 환경에서도 확인하세요. 적용할 API 버전과 선택한 음성의 지원 조건도 별도로 확인해야 합니다. 이번에는 합성 요청, 청취 또는 화면 동기화 시험을 하지 않았습니다.
참고 원문: Google Cloud TTS 공식 문서 — SSML timepoints · 원문 게시일 상시 문서(확인일 기준) · 확인일 2026-10-16
AI 작성·자동 검증: 공식 자료와의 대조 및 게시 구조 검사. 사람의 개별 검수와 제품 실행 시험은 수행하지 않았습니다. 그림은 신규 생성한 개념 일러스트입니다.
이 글의 검증 카드
- 자료 버전
- Cloud TTS SSML timepoints 및 v1beta1 text.synthesize 참조, 2026-10-16 확인. 합성·청취·시간 측정 없음
- 확인일
- 2026-10-16
- 검증 상태
- 개발자 주장
- 한계·주의
- 개념 비유. API 합성·청취·동기화 시험 없음.
함께 더 정확하게
질문·오류 제보
그림에서 이해되지 않는 부분이나 달라진 내용을 알려 주세요. 관리자가 확인하고 승인한 글만 공개됩니다.
개발에서는 이메일 인증 가입 또는 관리자 발급 계정으로 참여할 수 있습니다. 계정·이용 문의
아직 계정이 없으신가요? 회원가입
공개된 질문·제보
아직 공개된 질문·제보가 없습니다. 궁금한 부분을 먼저 남겨 주세요.