178 lines
5.6 KiB
Markdown
178 lines
5.6 KiB
Markdown
# Работа с изображениями в VNDB Telegram Bot
|
||
|
||
## Поддерживаемые изображения
|
||
|
||
Бот может отправлять изображения для:
|
||
- **Визуальные новеллы** - обложки и постеры
|
||
- **Персонажи** - аватары и официальные картинки
|
||
- **Релизы** - коробки и обложки физических изданий
|
||
|
||
## Использование изображений
|
||
|
||
### 1. Автоматическая отправка при поиске
|
||
|
||
При поиске бот автоматически отправляет изображения для первых 3 результатов:
|
||
|
||
```
|
||
/search Steins Gate
|
||
```
|
||
|
||
Бот вернёт:
|
||
- Текстовую информацию со списком найденных ВН
|
||
- Обложки первых 3 ВН
|
||
|
||
### 2. Детальный просмотр с полной информацией
|
||
|
||
Для получения полной информации с изображением используйте команды подробного просмотра:
|
||
|
||
#### Просмотр визуальной новеллы
|
||
|
||
```
|
||
/vn_detail v17
|
||
```
|
||
|
||
Отправит:
|
||
- Обложку ВН (высокое качество)
|
||
- Полная информация:
|
||
- Название и оригинальное название
|
||
- Дата выпуска
|
||
- Рейтинг и количество голосов
|
||
- Длительность
|
||
- Разработчик
|
||
- Описание
|
||
- Ссылка на VNDB
|
||
|
||
#### Просмотр персонажа
|
||
|
||
```
|
||
/char_detail c1
|
||
```
|
||
|
||
Отправит:
|
||
- Аватар персонажа
|
||
- Информация:
|
||
- Имя и оригинальное имя
|
||
- Пол
|
||
- Группа крови
|
||
- Список ВН, в которых появляется персонаж
|
||
- Описание
|
||
|
||
#### Просмотр релиза
|
||
|
||
```
|
||
/release_detail r1
|
||
```
|
||
|
||
Отправит:
|
||
- Картинку релиза
|
||
- Информация:
|
||
- Название
|
||
- Дата выпуска
|
||
- Платформа
|
||
- Тип (оригинальный, фан-перевод и т.д.)
|
||
- Языки
|
||
- Издание
|
||
- ВН, к которой относится
|
||
- Описание
|
||
|
||
## Примеры
|
||
|
||
### Поиск и просмотр ВН
|
||
|
||
```
|
||
# Найти ВН по названию
|
||
/search Clannad
|
||
|
||
# Просмотреть детали найденной ВН
|
||
/vn_detail v4
|
||
```
|
||
|
||
### Поиск и просмотр персонажа
|
||
|
||
```
|
||
# Найти персонажа
|
||
/char Nagisa
|
||
|
||
# Просмотреть детали персонажа
|
||
/char_detail c82
|
||
```
|
||
|
||
### Поиск и просмотр релиза
|
||
|
||
```
|
||
# Найти релиз
|
||
/release Clannad Windows
|
||
|
||
# Просмотреть детали релиза
|
||
/release_detail r500
|
||
```
|
||
|
||
## 🔗 Как найти ID элемента
|
||
|
||
### ID визуальной новеллы
|
||
- На сайте VNDB URL выглядит как: `https://vndb.org/v17`
|
||
- ID: `v17`
|
||
|
||
### ID персонажа
|
||
- На сайте VNDB URL: `https://vndb.org/c1`
|
||
- ID: `c1`
|
||
|
||
### ID релиза
|
||
- На сайте VNDB URL: `https://vndb.org/r123`
|
||
- ID: `r123`
|
||
|
||
### ID посредством поиска
|
||
При поиске бот показывает ID в формате:
|
||
```
|
||
1. **Steins;Gate**
|
||
ID: v17
|
||
```
|
||
|
||
Скопируйте ID и используйте в команде подробного просмотра:
|
||
```
|
||
/vn_detail v17
|
||
```
|
||
|
||
## Обработка ошибок при изображениях
|
||
|
||
Если изображение недоступно или бот не может его отправить:
|
||
- Бот вернёт текстовую информацию без изображения
|
||
- Информация будет полной и точной
|
||
- Вы по-прежнему можете посетить VNDB напрямую для просмотра изображения
|
||
|
||
## Источник изображений
|
||
|
||
Все изображения загружаются с официального CDN VNDB:
|
||
- **URL база**: `https://t.vndb.org`
|
||
- **Качество**: Оптимальное для отображения в Telegram
|
||
|
||
## Советы
|
||
|
||
1. **Для быстрого поиска**: используйте `/search`, `/char`, `/release`
|
||
- Автоматически получите первые изображения
|
||
- Быстрый просмотр информации
|
||
|
||
2. **Для подробной информации**: используйте `/vn_detail`, `/char_detail`, `/release_detail`
|
||
- Полная информация о элементе
|
||
- Высокое качество изображения
|
||
- Ссылка на официальный VNDB
|
||
|
||
3. **Сочетание команд**: сначала найдите элемент, потом просмотрите детали
|
||
```
|
||
/search Steins Gate
|
||
# Видите v17 в результатах
|
||
/vn_detail v17
|
||
# Получаете полную информацию с обложкой
|
||
```
|
||
|
||
## Примечания
|
||
|
||
- Не все элементы имеют изображения в VNDB
|
||
- Если изображение отсутствует, бот отправит только текстовую информацию
|
||
- Качество изображений зависит от наличия и разрешения в базе данных VNDB
|
||
- Бот поддерживает максимум до 3 изображений при поиске (для экономии трафика и скорости)
|
||
|
||
---
|
||
|
||
Для других вопросов см. `/help` или README.md
|