Logic Apps bağlayıcısı ile kullanma

  • Makale

Azure AI Video Indexer (VI) REST API,hem sunucudan sunucuya hem de istemciden sunucuya iletişimi destekler. API, video ve ses içgörülerini uygulama mantığınızla tümleştirmenizi sağlar.

Azure AI Video Indexer API'siyle uyumlu Logic Apps ve Power Automate bağlayıcılarını destekliyoruz.

Tek bir kod satırı yazmadan büyük miktarda video ve ses dosyasının içgörülerini etkili bir şekilde dizine almak ve ayıklamak için özel iş akışları ayarlamak için bağlayıcıları kullanabilirsiniz. Tümleştirme için bağlayıcıları kullanmak, iş akışınızın durumu ve hata ayıklamanın bir yolu hakkında görünürlük sağlar.

Giriş

Bu makaledeki örnekte Logic App akışları oluşturulur. Logic App ve Power Automate özellikleri ve düzenleyicileri neredeyse aynıdır.

birlikte çalışan iki akış yaklaşımı, daha büyük dosyaların zaman uyumsuz olarak karşıya yüklenmesini ve dizine yüklenmesini etkili bir şekilde destekler.

  • Azure Depolama hesabına bir blob eklendiğinde veya değiştirildiğinde ilk akış tetikleniyor. Dizin oluşturma işlemi tamamlandıktan sonra bildirim göndermek için yeni dosyayı geri çağırma URL'si ile Azure AI Video Indexer'a yükler.
  • İkinci akış, geri çağırma URL'si temelinde tetikler ve ayıklanan içgörüleri Azure Depolama'daki bir JSON dosyasına kaydeder.

Bu makalede oluşturduğunuz mantıksal uygulamalar, uygulama başına bir akış içerir. İkinci bölüm olan Create a new logic app of type consumption (Tüketim türünde yeni bir mantıksal uygulama oluşturma) bölümünde ikisinin nasıl bağlanacağı açıklanır. İkinci akış tek başına kalır ve ilk akış tarafından tetikler.

İlk akıştan karşıya yüklenen ve dizine alınan bir dosya, ikinci akışı tetikleyecek doğru geri çağırma URL'sine sahip bir HTTP isteği gönderir. Ardından Azure AI Video Indexer tarafından oluşturulan içgörüleri alır. Bu örnekte, dizin oluşturma işinizin çıkışını Azure Depolama'nızda depolar. Ancak, çıktıyla ne yaptığınız size bağlı.

Önkoşullar

  • Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir Azure hesabı oluşturun.
  • ARM tabanlı bir Azure AI Video Indexer hesabı oluşturun.
  • Bir Azure Depolama hesabı oluşturun. VI için depolama hesapları Standart genel amaçlı v2 depolama hesabı olmalıdır. Depolama hesabınızın erişim anahtarını not edin.
    • İki kapsayıcı oluşturun: biri medya dosyalarını, diğeri de Azure AI Video Indexer tarafından oluşturulan içgörüleri depolamak için. Bu makalede kapsayıcılar ve insightsşeklindedirvideos.

Erişim belirteci oluşturma

  1. generateAccessToken kullanarak bir erişim belirteci oluşturun. Hesabınız için doğru değerleri almak için Deneyin'e basın.
  2. Sonraki bir adım için kopyalayıp Not Defteri'ne yapıştırın.

Akış #1: Dosya karşıya yükleme akışını ayarlama

Bu bölümde ilk, dosya karşıya yükleme ve akışın nasıl ayarlanacağı açıklanmaktadır. Azure Depolama hesabına bir blob eklendiğinde veya değiştirildiğinde ilk akış tetikleniyor. Dizin oluşturma işlemi tamamlandıktan sonra bildirim göndermek için yeni dosyayı geri çağırma URL'si ile Azure AI Video Indexer'a yükler.

Akış adımları şunlardır:

  1. Blob eklendiğinde veya değiştirildiğinde (yalnızca özellikler) (V2)
  2. Yola göre SAS URI'sı oluşturma (V2)
  3. HTTP
  4. Videoyu ve dizini karşıya yükleme

Blog eklendiğinde veya değiştirildiğinde (yalnızca özellikler)(V2) adımını oluşturma

  1. Mantıksal Uygulamayı Azure Video Indexer hesap bölgesiyle aynı bölgede oluşturun (önerilen ancak gerekli değildir).

  2. Mantıksal uygulamayı UploadIndexVideosAppçağırın.

    1. Plan türü için Tüketim'i seçin.
    2. Gözden Geçir + Oluştur ->Oluştur'a basın.
    3. Mantıksal Uygulama dağıtımı tamamlandıktan sonra Azure portalında arama yapın ve yeni oluşturulan Mantıksal Uygulama'ya gidin.
    4. Ayarlar bölümünün altında, sol taraftaki panelde Kimlik sekmesini seçin.
    5. Sistem atandı altında, Durum değerini Kapalı olan Açık olarak değiştirin (adım bu öğreticinin sonraki bölümlerinde önemlidir).
    6. Kaydet'e (sayfanın üst kısmında) basın.
    7. Soldaki bölmede Mantıksal uygulama tasarımcısı sekmesini seçin.
    8. Boş bir Mantıksal Uygulama akışı seçin.
    9. İşlem Seçin dikey penceresinde "blob" ifadesini arayın.
    10. Tümü sekmesinde Azure Blob Depolama bileşenini seçin.
    11. Tetikleyiciler'in altında Blob eklendiğinde veya değiştirildiğinde (yalnızca özellikler) (V2) tetikleyicisini seçin.

  3. Blob eklendiğinde veya değiştirildiğinde (yalnızca özellikler) (V2) tetikleyicisi oluşturun.

  4. Depolama bağlantısını şu değerlere ayarlayın:

    Anahtar Value
    Bağlantı adı <Bağlantınıza bir ad verin>.
    Authentication type Erişim Tuşu
    Azure Depolama Hesabı adı <Medya dosyalarının depolandığı depolama> hesabı adı.
    Azure Depolama Hesabı Erişim Anahtarı Depolama hesabınızın erişim anahtarını almak için: Azure portalında -> my-storage -> Güvenlik + ağ ->Erişim anahtarları -> anahtarlardan birini kopyalayın.
    1. Oluştur'u belirleyin.
    2. Değişiklikler için izlenen blob depolama kapsayıcısını belirtin.
    Anahtar Değer
    Depolama hesabı adı Medya dosyalarının depolandığı depolama hesabı adı
    Kapsayıcı /videos
    1. Kaydet 'i seçin ->

Yola göre SAS URI'sı oluşturma (V2)

  1. +Yeni adım'ı seçin

  2. Yola göre SAS URI'si eylemi oluşturun.

    1. Eylem sekmesini seçin.
    2. Yola göre SAS URI'sini oluştur (V2) için arama yapın ve seçin.
    Anahtar Değer
    Depolama hesabı adı <Medya dosyalarının depolandığı> depolama hesabı adı.
    Blob yolu Dinamik içerik'in altında Dosya Yolu Listesi'ne tıklayın
    Grup İlkesi Tanımlayıcısı Varsayılan değeri değiştirmeyin.
    İzinler Okuma
    Paylaşılan Erişim protokolü (Yeni parametre ekle'ye basıldıktan sonra görüntülenir) HttpsOnly
    1. Kaydet'i seçin.

  3. +Yeni Adım'ı seçin.

HTTP eylemi oluşturma

  1. Aşağıdaki tabloda yer alan değerleri kullanarak bir HTTP eylemi arayın ve oluşturun:

    Anahtar Değer Notlar
    Metot POST
    URI [Erişim belirteci] (erişim belirteci #generate)
    Gövde { "permissionType": "Contributor", "scope": "Account" } REST belgesi örneğine bakın, POST satırını sildiğinizden emin olun.
    Yeni parametre ekle Kimlik Doğrulaması
    1. Kimlik doğrulaması için gerekli parametreleri aşağıdaki tabloya göre doldurun:
    Anahtar Değer
    Authentication type Yönetilen kimlik
    Yönetilen kimlik Sistem tarafından atanan yönetilen kimlik
    Hedef Kitle https://management.core.windows.net
    1. Kaydet'i seçin.

İzinleri ayarlama

  1. Mantıksal uygulama ile Azure AI Video Indexer hesabı arasındaki izinleri ayarlayın.

  2. Azure AI Video Indexer kaynağında izin için sistem tarafından atanan yönetilen kimliği ayarlayın. Azure portalında Azure AI Video Indexer kaynağınıza/hesabınıza gidin.

    1. Sol taraftaki dikey pencerede Erişim denetimi'ni seçin.
    2. Ekle ->Rol ataması ekle ->Katkıda Bulunan -Sonraki ->>Kullanıcı, grup veya hizmet sorumlusu ->+Üyeleri seçin'i seçin.
    3. Üyeler altında, oluşturduğunuz Logic Apps adını (bu örnekte) UploadIndexVideosApparayın.
    4. Seç'e basın.
    5. Gözden Geçir + ata'ya basın.

Video ve dizin karşıya yükleme eylemi oluşturma

  1. Video Indexer(V2)'yi seçin.

  2. Video Indexer(V2) bölümünden Videoyu ve dizini karşıya yükle'yi seçin.

  3. Aşağıdaki tabloda yer alan parametrelerle Video Indexer hesabına bağlantıyı ayarlayın:

    Anahtar Value
    Bağlantı adı <Bu durumda aviconnectionbağlantı> için bir ad girin.
    API key Bu, geliştirici portalındaki Profil bölümünde bulunan kişisel API anahtarınızdır çünkü bu Mantıksal Uygulama ARM hesaplarına yöneliktir, gerçek API anahtarına ihtiyacımız yoktur ve 12345 gibi sahte bir değer girebilirsiniz

    1. Oluştur'u belirleyin.

    2. Dolgu Karşıya yükleme video ve dizin eylemi parametreleri.

      İpucu

      VI Hesap Kimliği bulunamıyorsa ve açılan listede yoksa, özel değeri kullanın.

      Anahtar Değer
      Konum İlişkili Azure AI Video Indexer hesabının konumu.
      Hesap Kodu İlişkili Azure AI Video Indexer hesabının hesap kimliği. Hesap Kimliğini, hesabınızın Genel Bakış sayfasında, Azure portalında bulabilirsiniz. Veya Azure AI Video Indexer web sitesinin solundaki Hesap ayarları sekmesi.
      Erişim Belirteci body('HTTP')['accessToken'] Önceki HTTP çağrısından erişim belirtecini doğru biçimde ayıklamak için ifadesini kullanın.
      Video Adı Blob eklendiğinde veya değiştirildiğinde eyleminin dinamik içeriğinden Dosya Adı Listesi'ni seçin.
      Video URL'si Yola göre SAS URI'si oluştur eyleminin dinamik içeriğinden Web Url'sini seçin.
      Gövde Varsayılan olarak bırakılabilir.

    3. Kaydet'i seçin.

Akış 2: Tür tüketimine sahip yeni bir mantıksal uygulama oluşturma

İkinci akışı (tüketim türünde Logic Apps) oluşturun. İkinci akış, geri çağırma URL'si temelinde tetikler ve ayıklanan içgörüleri Azure Depolama'daki bir JSON dosyasına kaydeder.

Akış adımları şunlardır:

  1. Bir HTTP isteği alındığında
  2. HTTP
  3. Video Dizini Alma
  4. Blob oluşturma (V2)

Tetikleyiciyi ayarlama

  1. HTTP isteği alındığında'yı arayın ve seçin.

    Tetikleyici için bir HTTP POST URL alanı vardır. Siz akışınızı kaydedene kadar URL oluşturulmaz; ancak sonunda URL'ye ihtiyacınız olacaktır.

    İpucu

    Bu adımda oluşturulan URL'ye geri döneceğiz.

Erişim belirteci oluşturma

İlkini nasıl ayarladığınıza bağlı olarak başka bir erişim belirteci oluşturmanız gerekebilir. Kopyalayıp Not Defteri'ne yapıştırın.

  1. Erişim belirteci oluşturma.
  2. Kaydet -+ Yeni adım'ı seçin.>

Video Indexer içgörülerini alma

  1. "Video Indexer" için arama yapın.

  2. Video Indexer(V2)'de Video Dizini Al eylemini seçin.

    Bağlantı adını ayarlayın:

    Anahtar Value
    Bağlantı adı <Bağlantı> için bir ad. Örneğin, aviconnection.
    API key Bu, geliştirici portalındaki Profil bölümünde bulunan kişisel API anahtarınızdır. Daha fazla bilgi için bkz . API'ye abone olma.

    1. Oluştur'u belirleyin.

    2. Gerekli parametreleri tabloya göre doldurun:

      Anahtar Değer
      Konum Azure AI Video Indexer hesabının konumu.
      Hesap Kodu Video Indexer hesap kimliği, Azure portalındaki kaynak/hesaba Genel Bakış sayfasından kopyalanabilir.
      Video Kimliği* Video Kimliği için İfade türünde dinamik içerik ekleyin ve şu ifadeyi girin: triggerOutputs()['queries']['id'].
      Erişim Belirteci Dinamik içerikten JSON Ayrıştır bölümünün altında JSON ayrıştır eyleminin çıktısı olan accessToken öğesini seçin.

      *Bu ifade, bağlayıcıya tetikleyicinizin çıkışından Video Kimliğini almasını söyler. Bu durumda, tetikleyicinizin çıkışı, ilk tetikleyicinizde Video ve dizin yükleme çıkışı olacaktır.

    3. Kaydet -+ Yeni adım'ı seçin.>

Bir blob oluşturun ve içgörü JSON'unu depolayın.

  1. Eylem grubundan "Azure blobu" araması yapın.

  2. Blob oluştur(V2)'yi seçin.

  3. JSON içgörü dosyalarını depolayacak blob depolama bağlantısını ayarlayın.

    Anahtar Value
    Bağlantı adı <Bir bağlantı adı> girin.
    Authentication type Erişim Tuşu
    Azure Depolama Hesabı adı <* İçgörülerin depolanacağı depolama hesabı adı*>.
    Azure Depolama Hesabı Erişim anahtarı Güvenlik + ağ ->>Erişim anahtarları - anahtarlardan> birini kopyalayın altında Azure portalına gidin.>
    1. Oluştur'u belirleyin.
    2. İçgörülerin depolanacağı klasörü ayarlayın.
    Anahtar Değer
    Depolama hesabı adı <JSON çıkışını içerecek depolama hesabı adını girin (bu öğreticide kaynak video ile aynıdır).>
    Folder path Açılan listeden /insights
    Blob adı Dinamik içerikten, Video Dizini Al bölümünde Ad ve ekle'yi _insights.jsonseçin, içgörüler dosya adı video adı + insights.json
    Blob içeriği Dinamik içerikte, Video Dizini Al bölümünün altında Gövde'yi seçin.
    1. Akışı kaydet'i seçin.

Bir dizin işi tamamlandığında bildirim almak için geri arama URL'sini güncelleştirin.

Akış kaydedildikten sonra tetikleyicide bir HTTP POST URL'si oluşturulur.

  1. Tetikleyiciden URL'yi kopyalayın.
  2. İlk akışa geri dönün ve Geri Arama URL'si parametresi için Video ve dizin yükle eylemine URL'yi yapıştırın.

her iki akışın da kaydedildiğinden emin olun.