Ana içeriğe geç

Video Sabitleme

AIBudsVideoStabilization, indirilen kaynağı korurken desteklenen bileşik altı eksenli kaydı sabitlenmiş MP4'e dönüştüren isteğe bağlı bir son işleme eklentisidir.

Bu bir aygıt içi kamera ayarı değildir ve canlı önizlemeyi sabitlemez. İşleme, Medya Dosyası İçe Aktarma yerel dosyayı ürettikten sonra başlar.

Animated flow map

Post-import stabilization pipeline

The downloaded original remains the durable fallback while eligible six-axis video moves through optional processing.

Import

Downloaded Source

Keep the downloaded source as the durable fallback.

Eligibility

Inspect Recording

Check metadata and supported six-axis recording data.

Optional processor

Stabilize Video

Create a derivative without replacing the source.

Preferred output

Stabilized MP4

Prefer the verified stabilized output for playback.

Safe fallback

Use Original File

Use the original when processing is skipped or fails.

  • Downloaded Sourcecontinues toInspect Recording
  • Inspect RecordingeligibleStabilize Video
  • Stabilize Videocontinues toStabilized MP4
  • Inspect Recordingnot processedUse Original File
  • Stabilize VideofailedUse Original File
Stabilization failure changes the derivative result, not the success of an already completed download.

İşlem Hattı Sınırı

AIBuds içe aktarmayı koordine eder ve kayıtlı VideoStabilizationPlugin öğesini çağırır. AIBudsVideoStabilization yerleşik uygulamayı sağlar. AIBudsAllInOne paket başlatılırken bunu kaydeder; modüler entegrasyonlar kaydı açıkça üstlenmelidir.

Modül ayrıca cihaz aktarımı olmadan zaten yerel olan bileşik bir kaydı işlemek için VideoStabilizer sunar. İşin iptal edilebilmesi için döndürülen VideoStabilizationTask tamamlanana kadar saklanmalıdır.

AI desteğiyle uygulayın

AI ile geliştirin

Bu iş akışını AI ile uygulayın

Resmî “AIBuds’tan Medya Aktarma” becerisini kullanarak iş akışını uygulamanıza uyarlayın.

https://docs-aibuds.github.io/tr/skills/import-aibuds-media adresini okuyup yönergeleri izleyin. Bu beceriyle “AIBuds’tan Medya Aktarma” iş akışını iOS projesinde uygulayıp doğrulayın.
Resmî beceriyi görüntüle

İşlemenin Nerede Yapılacağını Belirleyin

İçe aktarma ve sabitlemenin tek eşgüdümlü işlem olması gerekiyorsa SDK yönetimli işlemeyi kullanın. Ürün başka bir yerel veya sunucu tarafı işleyiciyi yönetiyorsa devre dışı bırakın. Uygunluğa yalnızca dosya uzantısından karar vermeyin; eklenti yerel dosyayı ve MediaFileInfoModel öğesini inceler.

Kaynak Dosyayı Koruyun

Eklenti sözleşmesi girdiyi değiştirmemeli veya kaldırmamalıdır. Başarılı olduğunda türetilmiş dosyayı, aksi durumda indirilen özgün dosyayı kullanın:

Swift
let playableURL = importedFile.stabilizedFileURL ?? importedFile.localFileURL

Sabitleme hatasını indirme hatası saymayın. Aktarım ve sabitlemeyi ayrı aşamalar olarak gösterin ve her dosyanın durumunu koruyun.

Durumları Yorumlama

DurumÜründeki anlamı
notRequiredAltı eksenli dosya değil; özgün dosyayı kullanın.
pendingİşlenmeyi bekliyor.
stabilizedİşleme başarılı; stabilizedFileURL tercih edin.
pluginUnavailableKayıtlı eklenti yok; özgün dosyayı koruyun.
skippedEklenti bu dosyayı işleyemiyor; özgün dosyayı koruyun.
failedİşleme başarısız; hatayı gösterin ve varsa özgün dosyayı koruyun.
disabledUygulama işlemeyi kendisi yönetiyor.

StabilizationStatus başvurusuna bakın. Çıktının bulunmasına bakarak eksik durumu çıkarsamayın.

Kalite ve Kaynak Dengesi

Yerleşik varsayılan yapılandırma trimRatio = 0.1 kullanır, averageBitRate = 0 olduğunda bit hızını hesaplar ve automatic seçer. Otomatik mod düşük bellek kullanan jiroskop/Metal motorunu tercih eder; jiroskop meta verisi veya Metal kullanılamadığında AWEIS'e dönebilir. Yapılandırma ayrıca kalibre odak uzaklığı, eksen eşleme, sensör zaman ofseti, jiroskop yumuşatma, AWEIS yarıçapı ve konsol çıktısı denetimleri sunar. Daha fazla kırpma görüntü alanını azaltır, yüksek bit hızı da depolama ve aktarım maliyetini artırır. Özel ayarları temsili koşullarda doğrulayın.

Testler paralel çalışmanın güvenli olduğunu göstermedikçe uygun dosyaları sırayla işleyin. Dosya ilerlemesini (0.0...1.0) toplu dizin/sayıdan ayrı tutun, arayüz güncellemelerini sınırlayın ve iptali yinelenebilir yapın. İşleme sırasında uygulama özgün, kısmi ve nihai dosyaları aynı anda tutabilir.

Saklama Kontrol Listesi

  • İsteğe bağlı modül ve lisans kaynağı paketleniyor.
  • Modüler başlatma yalnızca amaçlanan eklentiyi kaydediyor.
  • Tüm sabitleme durumları temsil ediliyor.
  • Oynatma sabitlenmiş çıktıyı tercih ediyor ve gerekirse özgün dosyaya dönüyor.
  • Aktarım, dosya başına işleme ve toplu tamamlanma ayrı tutuluyor.
  • İptal, kullanılabilir çıktıları ve özgün dosyaları koruyor.
  • Uzun videolar depolama, bellek, ısıl yük ve kesinti açısından test ediliyor.
  • Geçici ve saklanan medya gizlilik ve silme politikasına uyuyor.