Video Indexer (wersja zapoznawcza)

Łatwe wyodrębnianie szczegółowych informacji z filmów wideo i szybkie wzbogacanie aplikacji w celu ulepszenia odnajdywania i zaangażowania. Użyj łącznika usługi Video Indexer, aby przekształcić wideo w szczegółowe informacje.

Ten łącznik jest dostępny w następujących produktach i regionach:

Service	Klasa	Regiony
Logic Apps	Standard	Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:      - Azure regionach Chin      - Departament Obrony USA (DoD)

Metadane łącznika
Publisher	Microsoft

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:

Wartość domyślna	Parametry tworzenia połączenia.	Wszystkie regiony	Udostępnialne

Domyślny

Dotyczy: wszystkie regiony

Parametry tworzenia połączenia.

Jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power jest udostępniana innemu użytkownikowi, połączenie jest również udostępniane. Aby uzyskać więcej informacji, zobacz Omówienie łączników dla aplikacji kanwy — Power Apps | Microsoft Docs

Nazwa	Typ	Opis	Wymagane
Klucz API	securestring	Klucz interfejsu API dla tego interfejsu API	Prawda

Limity ograniczania

Nazwa	Wywołania	Okres odnowienia
Wywołania interfejsu API na połączenie	1200	60 sekund

Akcje

Aktualizowanie nazwy twarzy	Ta operacja aktualizuje nazwę danej twarzy i trenuje model twarzy, aby rozpoznać tę twarz w przyszłych filmach wideo.
Pobieranie adresu URL transkrypcji (VTT)	Ta operacja zwraca adres URL do pliku VTT z podpisami danego podziału.
Pobieranie adresu URL widżetu odtwarzacza	Ta operacja zwraca adres URL do widżetu odtwarzacza, w tym token dostępu.
Pobieranie adresu URL widżetu szczegółowych informacji	Ta operacja zwraca adres URL do widżetu usługi Cognitive Insights, w tym token dostępu.
Pobieranie kont	Zwraca szczegóły kont użytkownika.
Pobieranie podziału wideo	Ta operacja zwraca pełne szczegóły danego podziału, w tym wszystkie szczegółowe informacje (transkrypcja, OCR, osoby itp.).
Ponowne indeksowanie podziału wideo	Ta operacja ponownie indeksuje dany podział.
Ponowne indeksowanie podziału wideo (przy użyciu identyfikatora zewnętrznego)	Ta operacja ponownie indeksuje film wideo o danym identyfikatorze zewnętrznym.
Przekazywanie wideo i indeksu	Ta operacja przekazuje dany film wideo, rozpoczyna indeksowanie i zwraca nowy identyfikator podziału.
Przekazywanie wideo i indeksu (przy użyciu adresu URL)	Ta operacja przekazuje dany film wideo, rozpoczyna indeksowanie i zwraca nowy identyfikator podziału.
Usuwanie wideo i jego szczegółowych informacji	Ta operacja usuwa przekazane wideo i jeśli deleteInsights=true, a następnie usuwa wygenerowane szczegółowe informacje.
Uzyskiwanie adresu URL widżetu szczegółowych informacji (przy użyciu identyfikatora zewnętrznego)	Ta operacja zwraca adres URL do widżetu usługi Cognitive Insights, w tym token dostępu na podstawie danego identyfikatora zewnętrznego.
Uzyskiwanie stanu przetwarzania	Ta operacja pobiera stan przetwarzania podanego identyfikatora podziału i jeśli przetwarzanie zwraca postęp (np. 30%).
Wyszukiwanie tekstu lub twarzy	Ta operacja wykonuje wyszukiwanie i zwraca wyniki. Jeśli jest dostępna, zwraca dopasowania filtrów wyszukiwania w wynikach.

Aktualizowanie nazwy twarzy

Identyfikator operacji:

UpdateFaceName

Ta operacja aktualizuje nazwę danej twarzy i trenuje model twarzy, aby rozpoznać tę twarz w przyszłych filmach wideo.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Identyfikator wideo	id	True	string	Identyfikator podziału wideo.
Face Id	faceId	True	number	Identyfikator twarzy (z pliku json wideo).
Nowa nazwa	newName	True	string	Nowa nazwa twarzy (użyj polecenia "Nieznany #1/2/3...", aby uzyskać anonimowość).

Zwraca

response

object

Pobieranie adresu URL transkrypcji (VTT)

Identyfikator operacji:

GetVttUrl

Ta operacja zwraca adres URL do pliku VTT z podpisami danego podziału.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Identyfikator wideo	id	True	string	Identyfikator skojarzony z filmem wideo i jego podziałem.
Język	language		string	Żądany język tekstu.

Zwraca

Adres URL pliku VTT wideo.

Adres URL

string

Pobieranie adresu URL widżetu odtwarzacza

Identyfikator operacji:

GetPlayerWidgetUrl

Ta operacja zwraca adres URL do widżetu odtwarzacza, w tym token dostępu.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Identyfikator wideo	id	True	string	Identyfikator podziału wideo.

Zwraca

Adres URL widżetu odtwarzacza.

Adres URL

string

Pobieranie adresu URL widżetu szczegółowych informacji

Identyfikator operacji:

GetInsightsWidgetUrl

Ta operacja zwraca adres URL do widżetu usługi Cognitive Insights, w tym token dostępu.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Identyfikator wideo	id	True	string	Identyfikator skojarzony z filmem wideo i jego podziałem.
Typ widżetu	widgetType		string	Osoby, tonacje, słowa kluczowe lub wyszukiwanie.

Zwraca

Adres URL widżetu cognitive insights.

Adres URL

string

Pobieranie kont

Identyfikator operacji:

GetAccounts

Zwraca szczegóły kont użytkownika.

Zwraca

Nazwa	Ścieżka	Typ	Opis
		array of object
Identyfikator konta	id	string
Nazwa konta	name	string

Pobieranie podziału wideo

Identyfikator operacji:

GetBreakdown

Ta operacja zwraca pełne szczegóły danego podziału, w tym wszystkie szczegółowe informacje (transkrypcja, OCR, osoby itp.).

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Identyfikator wideo	id	True	string	Identyfikator podziału zwrócony przez interfejsy API przekazywania lub wyszukiwania.
Język	language		string	Żądany język tekstu.

Zwraca

Nazwa	Ścieżka	Typ	Opis
Identyfikator konta	accountId	string	Unikatowy identyfikator skojarzony z kontem.
Identyfikator wideo	id	string	Unikatowy identyfikator skojarzony z filmem wideo i jego podziałem.
Partition	partition	string	Partycja filmu wideo.
Nazwa	name	date-time	Nazwa wideo.
Opis	description	string	Opis filmu wideo.
Nazwa użytkownika	userName	string	Nazwa użytkownika konta wideo.
Czas tworzenia	createTime	date-time	Czas tworzenia filmu wideo.
Organizacja	organization	string	Konto organizacji należy do.
Tryb prywatności	privacyMode	string	Tryb prywatności filmu wideo.
State	state	string	Przekazywanie, przetwarzanie, przetwarzanie, przetwarzanie lub niepowodzenie).
Jest własnością	isOwned	boolean	Prawda, jeśli wideo jest własnością użytkownika.
Jest bazą	isBase	boolean	Prawda, jeśli wideo jest wideo podstawowe.
Podsumowane szczegółowe informacje	summarizedInsights	string	Podsumowanie szczegółowych informacji pobranych z podziałów filmu wideo
Tablica podziałów	breakdowns	string	Tablica podziałów filmu wideo.
Lubiane przez użytkownika	social.likedByUser	boolean	Prawda, jeśli film wideo został polubiony przez użytkownika. W przeciwnym razie fałsz.
Lubi	social.likes	integer	Liczba polubień w filmie wideo.
Widoki	social.views	integer	Liczba wyświetleń filmu wideo.

Ponowne indeksowanie podziału wideo

Identyfikator operacji:

Re-IndexBreakdown

Ta operacja ponownie indeksuje dany podział.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Identyfikator wideo	id	True	string	Identyfikator podziału wideo.
Adres URL wywołania zwrotnego	callbackUrl		string	Adres URL do powiadomienia po zakończeniu ponownego indeksowania.

Zwraca

response

object

Ponowne indeksowanie podziału wideo (przy użyciu identyfikatora zewnętrznego)

Identyfikator operacji:

Re-IndexBreakdownByExternalId

Ta operacja ponownie indeksuje film wideo o danym identyfikatorze zewnętrznym.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Identyfikator zewnętrzny	externalId	True	string	Identyfikator zewnętrzny (który został skojarzony z filmem wideo tej subskrypcji podczas przekazywania).
Adres URL wywołania zwrotnego	callbackUrl		string	Adres URL do powiadomienia po zakończeniu ponownego indeksowania.

Zwraca

response

object

Przekazywanie wideo i indeksu

Identyfikator operacji:

UploadVideoFileContent

Ta operacja przekazuje dany film wideo, rozpoczyna indeksowanie i zwraca nowy identyfikator podziału.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Zawartość pliku	fileContent	True	binary	Wideo w formie wieloczęściowej.
Język	language		string	Język wideo, który ma być używany podczas generowania transkrypcji.
Identyfikator zewnętrzny	externalId		string	Identyfikator zewnętrzny do skojarzenia z wideo (można wyszukać później).
Metadata	metadata		string	Metadane do skojarzenia z wideo (zostaną zwrócone w zapytaniach).
Opis	description		string	Opis wideo.
Partition	partition		string	Partycja do partycjonowania filmów wideo (używana do wyszukiwania określonej partycji).
Nazwa wideo	name	True	string	Nazwa wideo.
Prywatność	privacy	True	string	Prywatne, organizacji lub publiczne.
Adres URL wywołania zwrotnego	callbackUrl		string	Adres URL do powiadamiania o zakończeniu indeksowania.

Zwraca

Identyfikator skojarzony z filmem wideo i jego podziałem.

response

videoResponse

Przekazywanie wideo i indeksu (przy użyciu adresu URL)

Identyfikator operacji:

UploadVideo

Ta operacja przekazuje dany film wideo, rozpoczyna indeksowanie i zwraca nowy identyfikator podziału.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Adres URL wideo	videoUrl	True	string	Publiczny adres URL filmu wideo.
Język	language		string	Język wideo, który ma być używany podczas generowania transkrypcji.
Identyfikator zewnętrzny	externalId		string	Identyfikator zewnętrzny do skojarzenia z wideo (można wyszukać później).
Metadata	metadata		string	Metadane do skojarzenia z wideo (zostaną zwrócone w zapytaniach).
Opis	description		string	Opis wideo.
Partition	partition		string	Partycja do partycjonowania filmów wideo (używana do wyszukiwania określonej partycji).
Nazwa wideo	name	True	string	Nazwa wideo.
Prywatność	privacy	True	string	Prywatne, organizacji lub publiczne.
Adres URL wywołania zwrotnego	callbackUrl		string	Adres URL do powiadamiania o zakończeniu indeksowania.

Zwraca

Identyfikator skojarzony z filmem wideo i jego podziałem.

response

videoResponse

Usuwanie wideo i jego szczegółowych informacji

Identyfikator operacji:

DeleteBreakdown

Ta operacja usuwa przekazane wideo i jeśli deleteInsights=true, a następnie usuwa wygenerowane szczegółowe informacje.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Identyfikator wideo	id	True	string	Identyfikator skojarzony z filmem wideo i jego podziałem.
Usuwanie szczegółowych informacji	deleteInsights		boolean	Niezależnie od tego, czy chcesz usunąć wygenerowane szczegółowe informacje (prawda czy fałsz).

Zwraca

response

object

Uzyskiwanie adresu URL widżetu szczegółowych informacji (przy użyciu identyfikatora zewnętrznego)

Identyfikator operacji:

GetInsightsWidgetUrlByExternalId

Ta operacja zwraca adres URL do widżetu usługi Cognitive Insights, w tym token dostępu na podstawie danego identyfikatora zewnętrznego.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Identyfikator zewnętrzny	externalId	True	string	Identyfikator zewnętrzny do wyszukania (skojarzony z filmem wideo tej subskrypcji podczas przekazywania).
Typ widżetu	widgetType		string	Typ widżetu podrzędnego do uwzględnienia (Osoby, Tonacje, Słowa kluczowe, Wyszukiwanie).

Zwraca

Adres URL widżetu cognitive insights.

Adres URL

string

Uzyskiwanie stanu przetwarzania

Identyfikator operacji:

GetProcessingState

Ta operacja pobiera stan przetwarzania podanego identyfikatora podziału i jeśli przetwarzanie zwraca postęp (np. 30%).

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Identyfikator wideo	id	True	string	Identyfikator skojarzony z filmem wideo i jego podziałem.

Zwraca

Nazwa	Ścieżka	Typ	Opis
State	state	string	Przekazywanie, przetwarzanie, przetwarzanie, przetwarzanie lub niepowodzenie.
Progress	progress	string	Procent wideo, jeśli stan jest przetwarzany.

Wyszukiwanie tekstu lub twarzy

Identyfikator operacji:

Search

Ta operacja wykonuje wyszukiwanie i zwraca wyniki. Jeśli jest dostępna, zwraca dopasowania filtrów wyszukiwania w wynikach.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Zapytanie twarzy	face		string	Twarz do wyszukania.
Zapytanie tekstowe	query		string	Dowolny tekst do wyszukania.
Wyszukaj konto publiczne	searchInPublicAccount		string	Wartość True do wyszukania na koncie publicznym.
Prywatność	privacy		string	Prywatne, organizacji lub publiczne.
Zakres tekstu	textScope		string	Zakres do wyszukiwania.
Język	language		string	Aby wyszukać.
Identyfikator wideo	id		string	Identyfikator podziału wideo do wyszukania.
Partition	partition		string	Partycja do wyszukania.
Owner	owner		string	Właściciel do wyszukania.
Rozmiar strony	pageSize		number	Liczba wyników do zwrócenia.
Pomiń	skip		number	Liczba wyników do pominięcia (używana do stronicowania).
Tożsamość zewnętrzna	externalId		string	Identyfikator zewnętrzny do wyszukania (skojarzony z wideo podczas przekazywania).

Zwraca

Nazwa	Ścieżka	Typ	Opis
Results	results	array of object
Identyfikator konta	results.accountId	string	Z konta, które przesłało wideo.
Identyfikator wideo	results.id	string	Identyfikator skojarzony z filmem wideo i jego podziałem.
Partition	results.partition	string	Partycja filmu wideo.
Identyfikator zewnętrzny	results.externalId	string	Identyfikator zewnętrzny wideo (użytkownik podany podczas przekazywania).
Metadata	results.metadata	string	Metadane wideo.
Nazwa	results.name	string	Nazwa wideo.
Opis	results.description	string	Opis filmu wideo.
Czas tworzenia	results.createTime	date-time	Czas tworzenia filmu wideo.
Organizacja	results.organization	string	Konto organizacji należy do.
Tryb prywatności	results.privacyMode	string	Konto organizacji należy do.
Nazwa użytkownika	results.userName	string	Nazwa użytkownika konta wideo.
Jest własnością	results.isOwned	boolean	Prawda, jeśli wideo jest własnością użytkownika.
Jest bazą	results.isBase	boolean	Prawda, jeśli wideo jest wideo podstawowe.
State	results.state	string	Przekazywanie, przetwarzanie, przetwarzanie, przetwarzanie lub niepowodzenie.
Postęp przetwarzania	results.processingProgress	string	Procent postępu wideo, jeśli stan jest przetwarzany.
Czas trwania w sekundach	results.durationInSeconds	integer	Czas trwania filmu wideo w sekundach.
Adres URL miniatury	results.thumbnailUrl	string	Miniatura adresu URL filmu wideo.
Lubiane przez użytkownika	results.social.likedByUser	boolean	Prawda, jeśli film wideo został polubiony przez użytkownika. W przeciwnym razie fałsz.
Lubi	results.social.likes	integer	Liczba polubień wideo.
Widoki	results.social.views	integer	Liczba wyświetleń filmu wideo.
Dopasowania wyszukiwania	results.searchMatches	string	Tablica dopasowań do wyszukiwania i szczegółów dopasowań.

Definicje

videoResponse

Identyfikator skojarzony z filmem wideo i jego podziałem.

Identyfikator skojarzony z filmem wideo i jego podziałem.

Identyfikator wideo

string

obiekt

Jest to typ 'obiekt'.

ciąg

Jest to podstawowy typ danych "string".