Contoh kode berikut menunjukkan cara mendeteksi orang dalam file video menggunakan Video Intelligence API.
Video Intelligence dapat mendeteksi kehadiran manusia dalam file video dan melacak individu di seluruh segmen video atau video.
Deteksi orang dari file di Cloud Storage
Berikut ini cara mengirimkan permintaan anotasi ke Video Intelligence dengan fitur deteksi orang.
REST
Kirim permintaan anotasi video
Berikut ini cara mengirim permintaan POST ke
metode
videos:annotate
. Contoh tersebut menggunakan Google Cloud CLI untuk membuat token akses. Untuk mengetahui petunjuk cara menginstal gcloud CLI, baca Panduan Memulai Video Intelligence API.
Lihat juga PersonDetectionConfig
.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- INPUT_URI: bucket Cloud Storage yang berisi file yang ingin Anda beri anotasi, termasuk nama file-nya. Harus
diawali dengan
gs://
.
Contoh:
"inputUri": "gs://cloud-samples-data/video/googlework_short.mp4"
- PROJECT_NUMBER: ID numerik untuk project Google Cloud Anda
Metode HTTP dan URL:
POST https://videointelligence.googleapis.com/v1/videos:annotate
Meminta isi JSON:
{ "inputUri": "INPUT_URI", "features": ["PERSON_DETECTION"], "videoContext": { "personDetectionConfig": { "includeBoundingBoxes": true, "includePoseLandmarks": true, "includeAttributes": true } } }
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Anda akan melihat respons JSON seperti berikut:
Jika respons berhasil, Video Intelligence API akan menampilkan name
untuk
operasi Anda. Di atas menunjukkan contoh respons tersebut, dengan:
- PROJECT_NUMBER: jumlah project Anda
- LOCATION_ID: region Cloud tempat anotasi seharusnya dilakukan. Region cloud yang didukung adalah:
us-east1
,us-west1
,europe-west1
,asia-east1
. Jika tidak ada wilayah yang ditentukan, wilayah akan ditentukan berdasarkan lokasi file video. - OPERATION_ID: ID operasi yang berjalan lama yang dibuat
untuk permintaan dan diberikan dalam respons saat Anda memulai
operasi, misalnya
12345...
Mendapatkan hasil anotasi
Untuk mengambil hasil operasi, buat permintaan GET menggunakan nama operasi yang ditampilkan dari panggilan ke videos:annotate, seperti ditunjukkan dalam contoh berikut.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- OPERATION_NAME: nama operasi seperti yang ditampilkan oleh Video Intelligence API. Nama operasi memiliki format
projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID
- PROJECT_NUMBER: ID numerik untuk project Google Cloud Anda
Metode HTTP dan URL:
GET https://videointelligence.googleapis.com/v1/OPERATION_NAME
Untuk mengirim permintaan, perluas salah satu opsi berikut:
Anda akan menerima respons JSON yang mirip dengan yang berikut ini:
Anotasi deteksi bidikan ditampilkan sebagai daftarshotAnnotations
.
Catatan: Kolom done hanya ditampilkan jika nilainya True.
Ini tidak termasuk dalam respons dengan operasi yang belum selesai.
Download hasil anotasi
Salin anotasi dari sumber ke bucket tujuan: (lihat Menyalin file dan objek)
gsutil cp gcs_uri gs://my-bucket
Catatan: Jika output gcs uri disediakan oleh pengguna, anotasi akan disimpan dalam uri gcs tersebut.
Java
Untuk mengautentikasi ke Video Intelligence, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mengautentikasi ke Video Intelligence, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mengautentikasi ke Video Intelligence, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Bahasa tambahan
C#: Ikuti Petunjuk penyiapan C# di halaman library klien lalu buka Dokumentasi referensi Video Intelligence untuk .NET.
PHP: Ikuti petunjuk penyiapan PHP di halaman library klien lalu kunjungi Dokumentasi referensi Video Intelligence untuk PHP.
Ruby: Ikuti petunjuk penyiapan Ruby di halaman library klien, lalu buka Dokumentasi referensi Video Intelligence untuk Ruby.
Deteksi orang dari file lokal
Contoh berikut menggunakan deteksi orang untuk menemukan entity dalam video dari file video yang diupload dari komputer lokal Anda.
REST
Mengirim permintaan proses
Untuk melakukan deteksi orang pada file video lokal, lakukan enkode base64 atas isi file video tersebut. Untuk mengetahui informasi tentang cara mengenkode konten dengan base64 pada
konten file video, lihat Encoding Base64. Kemudian, buat permintaan POST ke
metode
videos:annotate
. Sertakan konten yang dienkode base64 di kolom inputContent
pada permintaan dan tentukan fitur PERSON_DETECTION
.
Berikut ini contoh permintaan POST menggunakan curl. Contoh tersebut menggunakan Google Cloud CLI untuk membuat token akses. Untuk mengetahui petunjuk cara menginstal gcloud CLI, baca Panduan Memulai Video Intelligence API
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- inputContent: File video lokal dalam format biner
Misalnya: 'AAAAGGZ0eXBtcDQyAAAAAGlzb21tcDQyAAGVYW1vb3YAAABsbXZoZAAAAADWvhlR1r4ZUQABX5ABCOxo AAEAAAEAAAAAAA4...' - PROJECT_NUMBER: ID numerik untuk project Google Cloud Anda
Metode HTTP dan URL:
POST https://videointelligence.googleapis.com/v1/videos:annotate
Meminta isi JSON:
{ "inputUri": "Local video file in binary format", "features": ["PERSON_DETECTION"], "videoContext": { "personDetectionConfig": { "includeBoundingBoxes": true, "includePoseLandmarks": true, "includeAttributes": true } } }
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Anda akan melihat respons JSON seperti berikut:
Jika permintaan berhasil, Video Intelligence name
untuk operasi Anda. Di atas menunjukkan contoh respons tersebut, dengan project-number
adalah nomor project Anda dan operation-id
adalah ID operasi jangka panjang yang dibuat untuk permintaan tersebut.
{
"name": "us-west1.17122464255125931980"
}
Mendapatkan hasil
Untuk mengambil hasil operasi, buat permintaan GET ke endpoint operations
dan tentukan nama operasi Anda.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- OPERATION_NAME: nama operasi seperti yang ditampilkan oleh Video Intelligence API. Nama operasi memiliki format
projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID
- PROJECT_NUMBER: ID numerik untuk project Google Cloud Anda
Metode HTTP dan URL:
GET https://videointelligence.googleapis.com/v1/OPERATION_NAME
Untuk mengirim permintaan, perluas salah satu opsi berikut:
Anda akan menerima respons JSON yang mirip dengan yang berikut ini:
Java
Untuk mengautentikasi ke Video Intelligence, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mengautentikasi ke Video Intelligence, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mengautentikasi ke Video Intelligence, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Bahasa tambahan
C#: Ikuti Petunjuk penyiapan C# di halaman library klien lalu buka Dokumentasi referensi Video Intelligence untuk .NET.
PHP: Ikuti petunjuk penyiapan PHP di halaman library klien lalu kunjungi Dokumentasi referensi Video Intelligence untuk PHP.
Ruby: Ikuti petunjuk penyiapan Ruby di halaman library klien, lalu buka Dokumentasi referensi Video Intelligence untuk Ruby.