음성 대본에 표식을 넣었다면 시점 정보 반환 설정도 함께 켜기

한 장의 그림으로 이해하기

음성 대본의 위치와 생성 음성의 시점을 연결하는 개념 비유다. 왼쪽 편집자가 대본에 꽂는 깃발은 SSML mark, 오른쪽에서 누르는 스위치는 시점 반환 설정, 시계가 그려진 종이는 반환된 timepoint 정보에 대응한다. 두 장면은 준비 절차이며 시간 경과나 실제 합성 결과가 아니다. 릴은 음성 출력이고, 시계 바늘은 실측 시간이 아니다. 표식을 넣는 것과 반환을 요청하는 조건을 함께 갖춰야 한다는 결론을 보여준다. 머그잔의 문구는 장식이며 기술 조건을 뜻하지 않는다. 실제 지원 음성·API 버전과 재생 동기화 검증은 생략한 비유다.
내용의 흐름을 표현한 설명용 그림입니다. 실제 제품 화면이나 실행 결과가 아닙니다.
그림 크게 보기 ↗ (새 탭)

이미지·영상·음성 · 판정 관망

그림을 글로 풀면

표식과 반환 설정

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 합성·청취·동기화 시험 없음.

함께 더 정확하게

질문·오류 제보

그림에서 이해되지 않는 부분이나 달라진 내용을 알려 주세요. 관리자가 확인하고 승인한 글만 공개됩니다.

공개된 질문·제보

    아직 공개된 질문·제보가 없습니다. 궁금한 부분을 먼저 남겨 주세요.