Interfejs API śledzi usługę Media Services

  • Artykuł

Logo usługi Media Services w wersji 3

Ostrzeżenie

Usługa Azure Media Services zostanie wycofana 30 czerwca 2024 r. Aby uzyskać więcej informacji, zobacz Przewodnik po wycofaniu usługi AMS.

Zasób usługi Media Services zawiera pliki multimedialne na skojarzonym koncie usługi Azure Storage. Te pliki zawierają dane dla ścieżek dźwiękowych, wideo i tekstowych. Interfejs API śledzenie umożliwia zrozumienie ścieżek w zasobie i zarządzanie nimi. Utwory są używane przez odtwarzacz wideo DASH lub HLS do prezentowania dźwięku, wideo i napisów lub podpisów (tekst) do odbiorców. Punkt końcowy przesyłania strumieniowego usługi Media Services komunikuje informacje o ścieżkach do odtwarzacza za pośrednictwem manifestów DASH lub list odtwarzania HLS po żądaniu.

Za pomocą interfejsu API śledzenie można wykonywać następujące czynności:

  • Pobierz listę ścieżek dźwiękowych, wideo i tekstowych w elemecie zawartości.
  • Dodaj lub usuń ścieżki tekstowe.
  • Dodaj lub usuń ścieżki audio.
  • Określ atrybuty ułatwień dostępu ścieżek tekstowych lub dźwiękowych.
  • Edytuj ścieżkę w Azure Portal lub pobierz ją, a następnie przekaż ją z powrotem do elementu zawartości.
  • Pokaż lub ukryj ścieżkę tekstową w odtwarzaczu wideo.

Uwaga

Ścieżkę tekstową można dodawać lub aktualizować tylko na elementy zawartości wideo na żądanie (VOD). Ponadto powiązanie późnego dźwięku nie jest obsługiwane w przypadku zasobów transmisji strumieniowej na żywo.

Ścieżki tekstowe

Używanie ścieżek tekstowych z lokalnie utworzonym nośnikiem

Po utworzeniu wideo lokalnie i wyeksportowaniu podpisów możesz przekazać te podpisy do elementu zawartości zawierającego nośnik na żądanie.

Ogólny przepływ pracy dotyczący używania ścieżek tekstowych z lokalnie utworzonym tekstem:

  1. Utwórz plik wideo i wyeksportuj podpisy do pliku w formacie VTT lub TTML.
  2. Przetłumacz lub w inny sposób edytuj plik VTT lub TTML i zapisz kopie dla:
    1. Ścieżka dla dodatkowego języka z tekstem opisowym spełniającym wymagania dotyczące ułatwień dostępu.
    2. Utwór do dodatkowego tekstu komentarza reżysera.
  3. WAŻNE: Należy dodać projektowania języka do nagłówka VTT, aby w odtwarzaczu klienta był wyświetlany prawidłowy język. Na przykład:
    WEBVTT
Language: en-us
  4. Przekaż film wideo do usługi Media Services.
  5. Utwórz przekształcenie i zadanie kodowania wideo.
  6. Przekaż dodatkowe ścieżki tekstowe.

Używanie ścieżek tekstowych z transkrypcją na żywo

Po włączeniu transkrypcji na żywo dla wydarzenia na żywo zostanie utworzona dodatkowa ścieżka tekstowa WebVTT oprócz ścieżki transkrypcji na żywo w czasie rzeczywistym, którą widzowie widzą w odtwarzaczu wideo na żywo. Ten plik WebVTT zawiera najlepszą wersję transkrypcji na żywo, która zawiera pełne zdania zamiast częściowych wyników w czasie rzeczywistym. Plik vtt można pobrać po udostępnieniu całej transkrypcji i usunięciu danych wyjściowych na żywo.

Ostrzeżenie

Końcowe automatycznie generowane pliki VTT transkrypcji na żywo są opóźnione do przetwarzania. Jeśli nie zaczekasz kilka minut przed usunięciem danych wyjściowych na żywo, zawartość w pliku zostanie obcięta. Ponadto transkrypcja na żywo nie jest dostępna do użycia z wieloma strumieniami wejściowymi dla wydarzenia na żywo.

Ogólny przepływ pracy dotyczący używania ścieżek tekstowych transkrypcji na żywo:

  1. Utwórz wydarzenie na żywo z włączoną transkrypcją na żywo i wybranym językiem źródłowym.
  2. Po zakończeniu wydarzenia na żywo poczekaj kilka minut, a następnie usuń dane wyjściowe na żywo. Zarchiwizowany zasób będzie dostępny na potrzeby przesyłania strumieniowego na żądanie. Prawidłowe adresy URL przesyłania strumieniowego będą nadal dostępne dla osób przeglądających.
  3. Wyświetl listę ścieżek w zarchiwizowanym zasobie lub wyświetl je w portalu. Zostanie wyświetlony plik WebVTT zawierający transkrypcję NBest. Będzie on miał rozszerzenie vtt. Plik ma nazwę auto-generated-best_XXX.vtt.
  4. Edytuj plik VTT w Azure Portal lub pobierz i edytuj go.
  5. Aby przedstawić ścieżkę tekstową w wielu językach, przetłumacz ścieżkę tekstu źródłowego na te języki i zapisz je jako osobne pliki dla każdego języka przy użyciu rozszerzenia vtt.
  6. Przekaż ścieżkę języka źródłowego oraz ścieżki tekstowe dla każdego języka.
  7. Jeśli nie używasz Azure Portal do przekazania pliku, edytuj (lub zaktualizuj) plik .ism, aby poinformować odtwarzacza, którego tekstu używać, a także ich etykietowania i widoczności przez:
    1. Programowe aktualizowanie manifestu przy użyciu interfejsu API śledzi przy użyciu jednego z zestawów SDK lub interfejsu wiersza polecenia:
      1. Node.JS
      2. Python
      3. .Netto
      4. Interfejs wiersza polecenia

Ważne

Podczas aktualizowania pliku ism upewnij się, że ukrywasz ścieżkę tekstową transkrypcji na żywo i pokaż ścieżkę tekstową w języku odpowiednim dla przeglądarki.

Ścieżki audio

Możesz dodać dodatkowe ścieżki audio do elementu zawartości, aby zapewnić widzom dźwięk w różnych językach, dodać opisowy dźwięk dla ułatwień dostępu lub dodać komentarz dyrektora.

Ogólny przepływ pracy dla ścieżek audio

  1. Utwórz dodatkowe ścieżki audio dla wydarzenia na żywo. Mogą być dźwiękami w różnych językach lub opisowym dźwięku używanym do ułatwień dostępu. Można również użyć ścieżki dźwiękowej do komentarza reżysera.
  2. Przekaż ścieżki dźwiękowe do zarchiwizowanego elementu zawartości.
  3. Zaktualizuj dane śledzenia, edytując plik manifestu w portalu lub aktualizując dane śledzenia przy użyciu interfejsu REST lub zestawu SDK.

Uwaga

Po usunięciu ścieżki audio lub tekstowej plik źródłowy nie zostanie usunięty z kontenera magazynu. Usługa Media Services ustawia dynamiczny program packager (punkt końcowy przesyłania strumieniowego), aby nie wyświetlać informacji o ścieżce w manifeście lub liście odtwarzania żądanej przez odtwarzacz wideo.

Szczegółowe instrukcje interfejsu API opisano w poniższych przykładach.

Przykłady

Instrukcje, samouczki i przewodniki Szybki start

Uzyskiwanie pomocy i obsługi technicznej

Możesz skontaktować się z usługą Media Services z pytaniami lub postępować zgodnie z naszymi aktualizacjami, korzystając z jednej z następujących metod: