라이브러리 관리
라이브러리는 Transy의 메인 화면으로, 등록된 모든 소설을 관리합니다.
라이브러리 화면
화면 구성
| 영역 | 설명 |
|---|---|
| 상단 바 | “라이브러리” 타이틀과 우측에 설정(톱니바퀴) 아이콘 버튼 |
| 검색 바 | 돋보기 아이콘과 “소설 검색…” 힌트 텍스트가 있는 입력 필드 |
| 소설 목록 | 등록된 소설 카드 목록 (세로 스크롤) |
| 플로팅 버튼 | 화면 우측 하단에 + 아이콘의 원형 버튼 (소설 추가) |
| 하단 배너 | 프리미엄 미구독 시 광고 배너 표시 |
소설 카드
각 소설은 카드 형태로 표시됩니다. 카드는 surfaceVariant 색상의 둥근 모서리 카드로 구성되며, 좌측에 정보 영역, 우측에 버튼 영역이 배치됩니다.
표시 정보
| 항목 | 설명 |
|---|---|
| 제목 | 소설 제목 (옆에 연필 아이콘 편집 버튼) |
| 작가 | “작가: [이름]” 형식으로 표시 (있는 경우) |
| 회차 수 | “총 N화” 형식으로 표시 |
| 최근 업데이트 | “yyyy.MM.dd HH:mm” 형식의 시간 표시 |
| 프리패치 상태 | 진행 중일 때 진행 표시 아이콘 표시 |
소설 검색
상단에 항상 표시되는 검색바에서 소설을 검색할 수 있습니다. 검색 바는 OutlinedTextField 스타일로, 좌측에 돋보기 아이콘이 있고 검색어 입력 시 우측에 X(Clear) 버튼이 나타납니다. 검색 중에는 “N/전체” 형식으로 검색 결과 수가 표시됩니다.
검색 대상
- 소설 제목
- 작가명
사용 방법
- 검색바에 검색어 입력
- 실시간으로 필터링된 결과 표시
- X 버튼으로 검색 종료
소설 관리 메뉴
소설 카드 우측에 관리 버튼들이 직접 표시됩니다.
카드 버튼 배치
카드 우측에 아이콘 버튼들이 가로로 배치됩니다:
- 편집(연필) 아이콘: 제목 옆에 위치, 소설 정보 편집
- 새로고침 아이콘: URL 소설에만 표시, 탭 시 회전 애니메이션 또는 로딩 인디케이터 표시
- 삭제(휴지통) 아이콘: 빨간색으로 표시, 삭제 확인 다이얼로그 호출
메뉴 항목
| 메뉴 | 설명 |
|---|---|
| 정보 편집 | 소설 제목, 작가, 설명 수정 및 AI 번역 |
| 새로고침 | 새 회차 확인 (URL 소설만) |
| 삭제 | 소설 삭제 |
정보 편집
소설 정보를 원하는 대로 수정할 수 있습니다.
편집 다이얼로그 구성
다이얼로그에는 다음 요소가 포함됩니다:
- 타이틀 영역: “소설 정보 편집” 제목과 “AI 번역” 버튼
- 제목 입력 필드: 필수 항목, 비어있으면 오류 표시
- 작가 입력 필드: 선택 항목
- 설명 입력 필드: 3~5줄 크기의 멀티라인 입력
- 번역 결과 카드: AI 번역 후 나타나며, 번역된 텍스트와 “적용” 버튼 표시
- 저장/취소 버튼: 하단에 배치
사용 방법
- 소설 카드의 편집(연필) 아이콘 클릭
- 정보 수정 또는 “AI 번역” 버튼으로 자동 번역
- 번역 결과가 마음에 들면 “적용” 버튼 클릭
- “저장” 클릭
참고: 원본 출처의 제목은 변경되지 않습니다.
AI 번역 기능
소설 제목과 줄거리를 AI로 자동 번역할 수 있습니다.
- 편집 다이얼로그에서 “AI 번역” 버튼 클릭
- AI가 제목과 줄거리를 한국어로 번역
- 번역 결과가 카드 형태로 표시됨:
- 번역된 제목: AI가 번역한 소설 제목
- 번역된 줄거리: AI가 번역한 소설 설명
- “적용” 버튼을 클릭하면 번역 결과가 입력 필드에 반영
- 필요 시 수동으로 추가 수정 후 “저장”
참고: AI 번역에는 유틸리티 폴백에 설정된 API가 사용됩니다. API 설정이 필요합니다.
소설 새로고침
URL로 추가한 소설은 새 회차를 확인할 수 있습니다.
개별 새로고침
- 소설 카드의 새로고침 아이콘 클릭
- 새로고침 중에는 아이콘 대신 원형 로딩 인디케이터(CircularProgressIndicator) 표시
- 새 회차 확인 및 추가
새로고침 결과
- 새 회차가 있으면 자동 추가
- 새 회차가 없으면 “업데이트 없음” 표시
참고: 파일/텍스트로 추가한 소설은 새로고침 불가
소설 삭제
소설을 라이브러리에서 삭제합니다.
삭제 확인 다이얼로그
삭제 아이콘 클릭 시 확인 다이얼로그가 표시됩니다:
- 제목: “소설 삭제”
- 내용: “‘[소설 제목]’을(를) 삭제하시겠습니까?” 형식의 확인 메시지
- 버튼: 빨간색 “삭제” 버튼과 “취소” 버튼
삭제 시 제거되는 데이터
- 소설 정보 (제목, 작가, 설명)
- 모든 회차 데이터
- 번역 캐시
- 컨텍스트 정보 (캐릭터, 용어 등)
- TTS 오디오 캐시
주의: 삭제된 데이터는 복구할 수 없습니다.
삭제 방법
- 소설 카드의 삭제 아이콘 클릭
- 확인 다이얼로그에서 “삭제” 클릭
빈 라이브러리
소설이 없는 경우 상세한 시작 가이드가 표시됩니다.
빈 라이브러리 가이드 구성
화면 중앙에 다음 요소들이 세로로 배치됩니다:
- 메인 아이콘: 원형 배경에 책 아이콘 (MenuBook)
- 제목: “등록된 소설이 없습니다”
- 설명: 소설 추가를 안내하는 텍스트
- 시작 가이드 카드: 3단계 가이드
- 1단계: + 버튼 터치
- 2단계: URL 입력
- 3단계: 저장 완료
- URL 예시 카드 (접을 수 있음): 올바른/잘못된 URL 예시
- 다른 입력 방법 안내: 파일 불러오기, 텍스트 붙여넣기 안내
- 소설 추가 버튼: 전체 너비의 Primary 색상 버튼
빠른 접근
소설 상세 화면으로
소설 카드의 아무 곳이나 탭하면 상세 화면으로 이동합니다. 상세 화면에서 회차 목록을 확인하고 원하는 회차를 선택하여 읽기를 시작할 수 있습니다.
문제 해결
소설이 표시되지 않음
- 검색 필터가 활성화되어 있는지 확인
- 앱을 재시작해 보세요
카드가 깨져 보임
- 앱 업데이트 확인
- 캐시 삭제 후 재시작
새로고침이 작동하지 않음
- 인터넷 연결 확인
- URL 소설인지 확인 (파일/텍스트는 불가)
- 파싱 룰이 유효한지 확인
| ← 텍스트 직접 입력 | 다음: 소설 업데이트 → |