Przebieg modelowania

Ta strona opisuje pełny przebieg zadania modelowania od utworzenia do pobrania wyników, przejścia między statusami zadania oraz zawartość wyników modelowania. Przed wywołaniem API wykonaj konfigurację opisaną na stronie Przewodnik integracji.

Wymagania dotyczące danych wejściowych

Wybierz dane wejściowe w zależności od potrzeb modelowania:

Typ danych wejściowych	Opis	Zalecenie
Pakiet sceny LCC2	Kompletny katalog sceny z powiązanymi zasobami, takimi jak `info/poses.json`, zawierający trajektorię skanowania	Preferowany, gdy potrzebne są dokładne detale modelu, wyraźne tekstury i czytelny tekst
Chmura punktów LAS	Chmura punktów LiDAR bez trajektorii skanowania. Musi zawierać kolor RGB (Point Data Record Format 2 / 3 / 5 / 7 / 8 / 10). Pliki LAS bez koloru nie są obsługiwane	Preferowana, gdy potrzebna jest wysoka dokładność wymiarowa
Chmura punktów PLY	Kompletna chmura punktów 3DGS; można ją przetworzyć bez trajektorii skanowania	Używaj, gdy nie masz ani pakietu sceny LCC2, ani chmury punktów LAS

Obsługiwane są dwie formy przesyłania:

Forma katalogu: Prześlij wiele plików bezpośrednio do katalogu input, zachowując ich ścieżki względne.
Forma archiwum: Prześlij plik .zip; serwer automatycznie go rozpakuje.

Minimalny przebieg integracji

Utwórz zadanie: Wywołaj Utworzenie zadania i pobranie poświadczeń przesyłania. Automatyczne modelowanie jest domyślnie włączone (autoRebuild = 1). Odpowiedź zawiera modelId zadania oraz tymczasowe poświadczenia potrzebne do przesyłania.
Prześlij dane wejściowe: Korzystając z tymczasowych poświadczeń z poprzedniego kroku, prześlij dane w częściach przez API magazynu obiektów odpowiedniego dostawcy chmury. Zobacz Tymczasowe poświadczenia przesyłania. Ostateczny Key pliku to savePath z dołączoną ścieżką względną pliku, na przykład savePath + "render2/info/poses.json".
Zgłoś zakończenie przesyłania: Po przesłaniu wszystkich plików wywołaj Aktualizacja statusu przesyłania z status = 3. System automatycznie rozpocznie modelowanie.
Odpytuj o postęp zadania: Wywołuj Lista zadań ze stronicowaniem lub Szczegóły zadań i obserwuj status oraz percent. status = 8 oznacza zakończenie modelowania; status = 9 oznacza niepowodzenie modelowania. Odpytuj nie częściej niż co 5 sekund.
Pobierz wyniki: Wywołaj Pobieranie wyników modelowania, aby uzyskać tymczasowe linki do pobrania.

Uwaga: Współbieżność zadań modelowania nie jest ograniczona. Możesz przesłać wiele zadań naraz; każde trafia do kolejki zaraz po przesłaniu i jest przydzielane przez centrum obliczeniowe, gdy zwolnią się węzły.

Inne obsługiwane przebiegi

Wznawianie przesyłania i wygasłe poświadczenia

Jeśli przesyłanie zostanie przerwane lub tymczasowe poświadczenia wygasną, wywołaj Ponowne pobranie poświadczeń przesyłania, aby uzyskać nowe tymczasowe poświadczenia przesyłania, a następnie kontynuuj przesyłanie wieloczęściowe.

Ręczne uruchomienie modelowania

Dotyczy sytuacji, gdy zadanie utworzono z autoRebuild = 0, a wszystkie dane wejściowe zostały przesłane. Wywołaj Uruchomienie zadania, aby ręcznie rozpocząć modelowanie.

Maszyna stanów zadania

status	Znaczenie	Opis
0	Oczekiwanie na przesłanie	Zadanie utworzone, przesyłanie nie rozpoczęte
1	Przesyłanie	Domyślny status po utworzeniu zadania
2	Przesyłanie wstrzymane	Wstrzymanie zgłoszone przez integratora
3	Przesyłanie zakończone	Po zgłoszeniu serwer skanuje katalog `input`; przy `autoRebuild = 1` modelowanie rozpoczyna się automatycznie
4	Przesyłanie nieudane	Niepowodzenie zgłoszone przez integratora
5	Oczekiwanie na kolejkę	Status zarezerwowany; nie występuje w scenariuszach Open API
6	W kolejce	Przekazane do centrum obliczeniowego, oczekuje na wolny węzeł
7	Modelowanie	Postęp modelowania śledź w polu `percent`
8	Modelowanie zakończone	Wywołaj API pobierania, aby uzyskać wyniki
9	Modelowanie nieudane	Przyczynę znajdziesz w polach `errorCode` i `failedReason`

Przejścia statusów przy automatycznym modelowaniu:

0 Waiting for upload → 1 Uploading → 3 Upload completed → 6 Queued → 7 Modeling → 8 Modeling completed
                           ↓                                                 ↓
                     4 Upload failed                                 9 Modeling failed

Wyniki modelowania

Po zakończeniu modelowania powstają poniższe wyniki. Najważniejsze do pobrania są trzy pliki w natywnych współrzędnych LCC.

Plik wynikowy	Wartość type	Opis	Jednostki i współrzędne
`model_align_scan.dxf`	`DXF`	Edytowalny rysunek wektorowy, siatka 3D 3DFACE	Milimetry, 1:1, natywne współrzędne LCC
`model_align_scan.glb`	`GLB`	Model 3D GLB, gotowy do podglądu lub użycia w silnikach	Metry, jawna oś Z w górę, natywne współrzędne LCC
`model_align_scan.blend`	`BLEND`	Edytowalny plik projektu Blender	Natywne współrzędne LCC
`model_align_scan.rvt`	`RVT`	Model Revit	Natywne współrzędne LCC

Pozostałe wyniki pomocnicze to obraz BEV rzutu kondygnacji, obraz nałożenia chmury punktów, obraz układu mebli, ogólny wyrenderowany podgląd oraz metadane transformacji współrzędnych coordinate_transform.json.