Файлова система

Beam държи постоянните потребителски данни отделно от заменимите кешове на приложението. Използвайте този справочник при архивиране, преместване, проверка или отстраняване на проблеми с инсталация на Beam.

Къде Beam съхранява потребителските файлове

Beam открива папката Videos на операционната система и създава Beam/user в нея. Пренасочена или локализирана папка Videos променя откритото местоположение, затова пътищата по-долу са обичайните стойности по подразбиране, а не твърдо зададени места.

• Windows: %USERPROFILE%\Videos\Beam\user
• macOS: ~/Movies/Beam/user
• Linux: ${XDG_VIDEOS_DIR:-~/Videos}/Beam/user

Отваряне на папката в Windows

Натиснете

Win+R

, поставете %USERPROFILE%\Videos\Beam\user, след което натиснете

↵

. Windows разширява %USERPROFILE% и отваря папката във File Explorer.

Отваряне на папката в macOS

Отворете Finder, натиснете

⌘+Shift+G

, поставете ~/Movies/Beam/user, след което натиснете

↵

. Finder разширява ~ до вашата домашна папка.

Отваряне на папката в Linux

Отворете файловия мениджър, натиснете

Ctrl+L

, въведете ~/Videos/Beam/user, след което натиснете

↵

. За пренасочена директория Videos изпълнете xdg-open "$(xdg-user-dir VIDEOS)/Beam/user" в терминал.

Папката се създава при нужда

Някои директории се появяват едва след първото използване на съответната функция. Направете един запис, преди да търсите projects/, или импортирайте фон, преди да търсите библиотеката с тапети.

Структура на потребителските данни

Директорията Beam/user може да съдържа следните постоянни данни:

Beam/user/
├── preferences.json
├── projects/
│   └── project-<readable-name>/
├── media/
│   └── wallpapers/
│       ├── image/
│       └── video/
└── models/
    └── whisper/

• preferences.json съхранява изгледа, поведението на рекордера, избраните устройства, клавишните комбинации, състоянието на въвеждането, предварителните настройки и запазеното разположение на прозореца. При нужда се създава или заменя с нормализирани стойности по подразбиране.
• projects/ съхранява всеки проект на Beam и неговите сесии за запис. Това е най-важната директория за архивиране.
• media/wallpapers/image/ и media/wallpapers/video/ съхраняват копия на фоновете, импортирани в общата библиотека с тапети. Те са незадължителни.
• models/whisper/ съхранява изтеглените локални модели за транскрипция, техните манифести и временни .partial изтегляния. Моделите са незадължителни и могат да бъдат изтеглени отново.

Записи и проекти

Всеки проект използва четливо име на директорията, например project-vivid-cosmic. Стабилният UUID на проекта се намира в project.json, така че името на директорията не е идентичността на проекта. Преименуването на проект може да преименува и директорията му.

Директория на проекта

Разработен проект може да изглежда така:

project-<name>/
├── project.json                         required
├── thumbnail.webp                       optional
├── media/                               optional imported editor media
├── backgrounds/                         optional project backgrounds
└── session-<uuid>/                      one or more recording sessions
    ├── manifest.json                    completed session
    ├── manifest.partial.json            interrupted/in-progress recovery state
    ├── health.jsonl                     capture diagnostics
    ├── timing.jsonl                     clock synchronization anchors
    ├── screen/                          screen video segments
    ├── system-audio/                    optional system-audio segments
    ├── microphone/                      optional microphone segments
    ├── camera/                          optional camera segments
    ├── cursor/                          optional cursor and interaction data
    └── session/teleprompter.json        optional teleprompter document

Задължителни метаданни на проекта

• project.json е манифестът на проекта и източникът на истината. Той съдържа версията на схемата, стабилния идентификатор на проекта, показваното име, времевите маркери, препратките към сесиите, композицията, настройките за представяне, субтитрите, състоянието на мащабирането и препратките към импортирани ресурси.
• Всяка завършена сесия обикновено има manifest.json, който описва платформата, избраните източници, разрешенията, предупрежденията, форматите на пистите, сегментите, показателите и състоянието на завършване.
• manifest.partial.json запазва възстановими метаданни, докато заснемането е активно или сесията не е финализирана. Възстановена сесия може законно да използва този файл вместо manifest.json.

Не редактирайте манифестите ръчно

Манифестите са версирани данни на приложението с препратки между файловете. Ръчното редактиране, преместването на отделни файлове на сесията или преименуването на файлове в проекта може да направи медиите недостъпни в редактора.

Директории за писти и медии

• screen/ съдържа номерирани MP4 сегменти на екрана, когато заснемането на екрана е успешно.
• system-audio/, microphone/ и camera/ съдържат номерирани WebM сегменти за съответните включени източници.
• Петте директории за писти могат да съществуват дори когато източникът не е избран. Използвайте записите и състоянията в tracks на манифеста на сесията, а не наличието на празна директория, за да определите какво е било записано.
• Временни .partial медийни файлове могат да съществуват по време на активно или прекъснато записване на браузърна медия. Финализираните сегменти се преименуват атомарно.
• media/ съдържа копия на видеа, изображения или аудио, импортирани в редактора. Премахването на неизползван импортиран ресурс чрез Beam може да премахне копирания му файл.
• backgrounds/ съдържа копия на фонове, импортирани конкретно в този проект.

Курсор, взаимодействия и диагностика

• cursor/cursor.json съдържа записани събития на курсора, когато заснемането на курсора е налично.
• cursor/telemetry.json съдържа нормализирани проби от движението на курсора, използвани от поведението на редактора, например следването на курсора.
• cursor/shapes.json описва нативните форми на курсора; cursor/shapes/*.png може да съдържа заснети растерни форми, когато това е необходимо за платформата или пътя за съвместимост.
• cursor/input.json съдържа разрешени метаданни за клавишни комбинации и взаимодействия с щракване. Въведеният текст не се съхранява.
• health.jsonl записва състоянието и прекъсванията на заснемането; timing.jsonl записва времеви опорни точки, използвани за подравняване на пистите. Пазете и двата файла със сесията при преместване или диагностициране на проект.

Незадължителни файлове за представяне

• thumbnail.webp е генериран преглед за картата на проекта и може да бъде създаден отново.
• session/teleprompter.json съществува само след като за тази сесия е запазен документ за телесуфльора.
• Генерираните субтитри и конфигурацията на редактора се съхраняват в project.json; те не са отделни файлове със субтитри в проекта.

Архивирайте цялата директория на проекта

Копирайте project-<name>/ като едно цяло, докато Beam не записва. Самостоятелен MP4 файл на екрана не съдържа композицията на редактора, незадължителните писти, данните за курсора, субтитрите или диагностиката.

Актуализации

Изтеглените актуализации се съхраняват в кеша на операционната система, отделно от проектите. Директорията pending/ може да съдържа инсталатора или архива на актуализацията и update-info.json. Beam изчиства кеша на актуализатора, след като новата версия се стартира успешно, като запазва актуализация, която все още чака инсталиране.

• Windows: %LOCALAPPDATA%\beam-updater\pending
• macOS: ~/Library/Caches/beam-updater/pending
• Linux: ${XDG_CACHE_HOME:-~/.cache}/beam-updater/pending

Състояние на актуализацията

Beam също съхранява update-cache-state.json в директорията с данни на приложението Electron, за да различава инсталирана актуализация от все още чакаща. Обичайните родителски директории са %APPDATA%\Beam в Windows, ~/Library/Application Support/Beam в macOS и ${XDG_CONFIG_HOME:-~/.config}/Beam в Linux.

Файловете на актуализатора са временни

Не архивирайте и не премествайте кеша на актуализатора. Ако няма активно изтегляне или актуализация, която чака рестартиране, кешът може да бъде премахнат и Beam ще изтегли бъдеща актуализация отново. Никога не го изтривайте, докато актуализация се изтегля или е готова за инсталиране.