System plików

Beam przechowuje trwałe dane użytkownika osobno od wymiennych pamięci podręcznych aplikacji. Skorzystaj z tego opisu podczas tworzenia kopii zapasowej, przenoszenia, sprawdzania lub rozwiązywania problemów z instalacją Beam.

Gdzie Beam przechowuje pliki użytkownika

Beam odnajduje systemowy folder Wideo i tworzy w nim Beam/user. Przekierowany lub zlokalizowany folder Wideo zmienia rozwiązaną lokalizację, dlatego poniższe ścieżki są typowymi wartościami domyślnymi, a nie lokalizacjami zapisanymi na stałe.

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

Otwórz folder w systemie Windows

Naciśnij

Win+R

, wklej %USERPROFILE%\Videos\Beam\user, a następnie naciśnij

↵

. Windows rozwinie %USERPROFILE% i otworzy folder w Eksploratorze plików.

Otwórz folder w systemie macOS

Otwórz Findera, naciśnij

⌘+Shift+G

, wklej ~/Movies/Beam/user, a następnie naciśnij

↵

. Finder rozwinie ~ do Twojego folderu domowego.

Otwórz folder w systemie Linux

Otwórz menedżer plików, naciśnij

Ctrl+L

, wpisz ~/Videos/Beam/user, a następnie naciśnij

↵

. W przypadku przekierowanego katalogu Wideo uruchom w terminalu xdg-open "$(xdg-user-dir VIDEOS)/Beam/user".

Folder jest tworzony na żądanie

Niektóre katalogi pojawiają się dopiero po pierwszym użyciu danej funkcji. Nagraj coś przed szukaniem projects/ albo zaimportuj tło przed szukaniem biblioteki tapet.

Układ danych użytkownika

Katalog Beam/user może zawierać następujące trwałe dane:

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

• preferences.json przechowuje wygląd, zachowanie rejestratora, wybrane urządzenia, skróty, stan wdrożenia, ustawienia wstępne i zapisaną pozycję okna. W razie potrzeby jest tworzony lub zastępowany znormalizowanymi wartościami domyślnymi.
• projects/ przechowuje każdy projekt Beam i jego sesje nagrywania. To najważniejszy katalog do utworzenia kopii zapasowej.
• media/wallpapers/image/ i media/wallpapers/video/ przechowują kopie teł zaimportowanych do wspólnej biblioteki tapet. Są opcjonalne.
• models/whisper/ przechowuje pobrane lokalne modele transkrypcji, ich manifesty i tymczasowe pobrania .partial. Modele są opcjonalne i można je pobrać ponownie.

Nagrania i projekty

Każdy projekt używa czytelnej nazwy katalogu, np. project-vivid-cosmic. Stabilny identyfikator UUID projektu znajduje się w project.json, więc nazwa katalogu nie jest tożsamością projektu. Zmiana nazwy projektu może także zmienić nazwę jego katalogu.

Katalog projektu

Rozwinięty projekt może wyglądać tak:

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

Wymagane metadane projektu

• project.json to manifest projektu i źródło prawdy. Zawiera wersję schematu, stabilny identyfikator projektu, nazwę wyświetlaną, znaczniki czasu, odwołania do sesji, kompozycję, ustawienia prezentacji, napisy, stan powiększeń i odwołania do zaimportowanych zasobów.
• Każda ukończona sesja zwykle ma manifest.json, który opisuje platformę, wybrane źródła, uprawnienia, ostrzeżenia, formaty ścieżek, segmenty, metryki i stan ukończenia.
• manifest.partial.json zachowuje możliwe do odzyskania metadane podczas aktywnego przechwytywania lub gdy sesja nie została sfinalizowana. Odzyskana sesja może prawidłowo używać tego pliku zamiast manifest.json.

Nie edytuj manifestów ręcznie

Manifesty to wersjonowane dane aplikacji z odwołaniami między plikami. Ręczne zmiany, przenoszenie pojedynczych plików sesji lub zmiana nazw plików w projekcie mogą sprawić, że multimedia przestaną być dostępne w edytorze.

Katalogi ścieżek i multimediów

• screen/ zawiera ponumerowane segmenty ekranu MP4, gdy przechwytywanie ekranu zakończyło się powodzeniem.
• system-audio/, microphone/ i camera/ zawierają ponumerowane segmenty WebM zapisane dla odpowiednich włączonych źródeł.
• Pięć katalogów ścieżek może istnieć nawet wtedy, gdy źródło nie zostało wybrane. Aby określić, co nagrano, użyj wpisów i stanów tracks z manifestu sesji, a nie obecności pustego katalogu.
• Podczas aktywnego lub przerwanego zapisu multimediów przez przeglądarkę mogą istnieć tymczasowe pliki .partial. Ukończone segmenty są zmieniane atomowo.
• media/ zawiera kopie filmów, obrazów lub dźwięków zaimportowanych do edytora. Usunięcie nieużywanego zaimportowanego zasobu z poziomu Beam może usunąć jego skopiowany plik.
• backgrounds/ zawiera kopie teł zaimportowanych konkretnie do tego projektu.

Kursor, interakcje i diagnostyka

• cursor/cursor.json zawiera zarejestrowane zdarzenia kursora, gdy przechwytywanie kursora jest dostępne.
• cursor/telemetry.json zawiera znormalizowane próbki ruchu kursora używane przez funkcje edytora, np. śledzenie kursora.
• cursor/shapes.json opisuje natywne kształty kursora; cursor/shapes/*.png może zawierać przechwycone kształty bitmapowe wymagane przez platformę lub ścieżkę zgodności.
• cursor/input.json zawiera dozwolone metadane skrótów i kliknięć. Wpisywany tekst nie jest zapisywany.
• health.jsonl rejestruje stan przechwytywania i przerwania; timing.jsonl rejestruje kotwice czasowe używane do wyrównywania ścieżek. Podczas przenoszenia lub diagnozowania projektu zachowaj oba pliki wraz z sesją.

Opcjonalne pliki prezentacji

• thumbnail.webp to wygenerowany podgląd karty projektu, który można odtworzyć.
• session/teleprompter.json istnieje dopiero po zapisaniu dokumentu telepromptera dla sesji.
• Wygenerowane napisy i konfiguracja edytora są przechowywane w project.json; nie są osobnymi plikami napisów w projekcie.

Wykonaj kopię zapasową całego katalogu projektu

Skopiuj project-<name>/ jako całość, gdy Beam nie nagrywa. Sam plik MP4 ekranu nie zawiera kompozycji edytora, opcjonalnych ścieżek, danych kursora, napisów ani diagnostyki.

Aktualizacje

Pobrane aktualizacje są przechowywane w pamięci podręcznej systemu operacyjnego, osobno od projektów. Katalog pending/ może zawierać instalator lub archiwum aktualizacji oraz update-info.json. Beam czyści pamięć podręczną aktualizatora po pomyślnym uruchomieniu nowej wersji, zachowując aktualizację oczekującą na instalację.

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

Stan aktualizacji

Beam przechowuje również update-cache-state.json w katalogu danych aplikacji Electron, aby odróżnić zainstalowaną aktualizację od nadal oczekującej. Typowe katalogi nadrzędne to %APPDATA%\Beam w systemie Windows, ~/Library/Application Support/Beam w macOS i ${XDG_CONFIG_HOME:-~/.config}/Beam w Linuxie.

Pliki aktualizatora można usunąć

Nie twórz kopii zapasowej ani nie przenoś pamięci podręcznej aktualizatora. Jeśli żadna aktualizacja nie jest pobierana ani nie czeka na ponowne uruchomienie, można ją usunąć, a Beam ponownie pobierze przyszłą aktualizację. Nigdy nie usuwaj jej podczas pobierania aktualizacji ani gdy jest gotowa do instalacji.