tencent cloud

Video on Demand

릴리스 노트 및 공지 사항
릴리스 노트
제품 소개
제품 개요
Product Features
제품 기능
제품 장점
시나리오
솔루션
구매 가이드
과금 개요
과금 방식
구매 가이드
청구서 조회
연장 안내
연체 안내
환불 안내
시작하기
콘솔 가이드
콘솔 소개
서비스 개요
애플리케이션 관리
미디어 관리
리소스 패키지 관리
License Management
사례 튜토리얼
미디어 업로드
VOD 미디어 파일을 스마트 콜드 스토리지하는 방법
비디오 처리
배포 및 재생
이벤트 알림 수신 방법
원본 서버 마이그레이션 방법
라이브 방송 녹화
사용자 지정 Origin-pull을 수행하는 방법
라이브 방송 하이라이트 클리핑을 VOD에 통합하기 위한 가이드
EdgeOne을 사용하여 VOD 콘텐츠 배포하는 방법
개발 가이드
미디어 업로드
미디어 처리
비디오 AI
이벤트 알림
비디오 재생
미디어 파일 다운로드
서브 애플리케이션 시스템
오류 코드
플레이어 SDK 문서
Overview
Basic Concepts
Features
Free Demo
Free Trial License
Purchase Guide
SDK Download
Licenses
Player Guide
Integration (UI Included)
Integration (No UI)
Advanced Features
API Documentation
Player Adapter
Player SDK Policy
FAQs
모바일 재생
요금
비디오 업로드
비디오 배포
비디오 재생
Web 재생
전체 화면 재생
데이터 통계
액세스 관리
미디어 자산 콜드 스토리지
Agreements
Service Level Agreement
VOD 정책
개인 정보 보호 정책
데이터 처리 및 보안 계약
문의하기
용어집
문서Video on Demand개발 가이드미디어 업로드서버 업로드Node.js SDK

Node.js SDK

PDF
포커스 모드
폰트 크기
마지막 업데이트 시간: 2023-10-26 17:31:32
VOD는 서버에서 동영상을 업로드하기 위한 Node.js용 SDK를 제공합니다. 업로드 프로세스에 대한 자세한 내용은 가이드를 참고하십시오.

통합 방법

npm을 사용하여 설치

npm i vod-node-sdk --save

소스 패키지를 통해 설치

npm 툴이 프로젝트의 종속성 관리에 사용되지 않는 경우 소스 코드를 다운로드하여 프로젝트로 가져올 수 있습니다.
GitHub에서 액세스
Node.js용 SDK 다운로드 링크

비디오 간편 업로드

업로드 객체 초기화

Tencent Cloud API 키로 VodUploadClient 인스턴스를 초기화합니다.
const { VodUploadClient, VodUploadRequest } = require('vod-node-sdk');

client = new VodUploadClient("your secretId", "your secretKey");

업로드 요청 객체 생성

let req = new VodUploadRequest();
req.MediaFilePath = "/data/file/Wildlife.mp4";

업로드 메소드 호출

업로드 메소드를 호출하고 액세스 포인트 리전과 업로드 요청을 전달한 후, 콜백을 통해 반환된 정보를 가져옵니다.
client.upload("ap-guangzhou", req, function (err, data) {
    if (err) {
        // 예외 처리
        console.log(err)
    } else {
        // 업로드 성공 후 정보 가져오기
        console.log(data.FileId);
        console.log(data.MediaUrl);
    }
});
설명：
업로드 방법은 파일 크기에 따라 일반 업로드 또는 멀티파트 업로드를 자동으로 선택하므로 멀티파트 업로드의 각 단계를 신경 쓸 필요가 없습니다.

고급 기능

커버 업로드

const { VodUploadClient, VodUploadRequest } = require('vod-node-sdk');

client = new VodUploadClient("your secretId", "your secretKey");
let req = new VodUploadRequest();
req.MediaFilePath = "/data/file/Wildlife.mp4";
req.CoverFilePath = "/data/file/Wildlife-cover.png";
client.upload("ap-guangzhou", req, function (err, data) {
    if (err) {
        // 예외 처리
        console.log(err)
    } else {
        // 업로드 성공 후 정보 가져오기
        console.log(data.FileId);
        console.log(data.MediaUrl);
        console.log(data.CoverUrl);
    }
});

태스크 플로우 지정

먼저 태스크 플로우 템플릿 생성 완료 후 이름을 지정합니다. 태스크 플로우를 시작할 때 태스크 플로우 템플릿 이름으로 Procedure 매개변수를 설정할 수 있으며, 업로드 성공 시 태스크 플로우가 자동으로 실행됩니다.
const { VodUploadClient, VodUploadRequest } = require('vod-node-sdk');

client = new VodUploadClient("your secretId", "your secretKey");
let req = new VodUploadRequest();
req.MediaFilePath = "/data/file/Wildlife.mp4";
req.Procedure = "Your Procedure Name";
client.upload("ap-guangzhou", req, function (err, data) {
    if (err) {
        // 예외 처리
        console.log(err)
    } else {
        // 업로드 성공 후 정보 가져오기
        console.log(data.FileId);
        console.log(data.MediaUrl);
    }
});

서브 애플리케이션에 업로드

서브 애플리케이션 ID를 전달합니다. 업로드 성공 후 리소스는 지정된 서브 애플리케이션에만 속하게 됩니다.
const { VodUploadClient, VodUploadRequest } = require('vod-node-sdk');

client = new VodUploadClient("your secretId", "your secretKey");
let req = new VodUploadRequest();
req.MediaFilePath = "/data/file/Wildlife.mp4";
req.SubAppId = 101;
client.upload("ap-guangzhou", req, function (err, data) {
    if (err) {
        // 예외 처리
        console.log(err)
    } else {
        // 업로드 성공 후 정보 가져오기
        console.log(data.FileId);
        console.log(data.MediaUrl);
    }
});

스토리지 리전 지정

콘솔에서 대상 스토리지 리전이 활성화되었는지 확인하고, 활성화되지 않은 경우 스토리지 설정 업로드에 따라 수행한 다음, StorageRegion 속성을 통해 스토리지 리전의 영어 약칭을 설정할 수 있습니다.
const { VodUploadClient, VodUploadRequest } = require('vod-node-sdk');

client = new VodUploadClient("your secretId", "your secretKey");
let req = new VodUploadRequest();
req.MediaFilePath = "/data/file/Wildlife.mp4";
req.StorageRegion = "ap-chongqing";
client.upload("ap-guangzhou", req, function (err, data) {
    if (err) {
        // 예외 처리
        console.log(err)
    } else {
        // 업로드 성공 후 정보 가져오기
        console.log(data.FileId);
        console.log(data.MediaUrl);
    }
});

임시 자격 증명으로 업로드

임시 자격 증명의 관련 키 정보를 전달하여 인증 및 업로드에 임시 자격 증명을 사용합니다.
const { VodUploadClient, VodUploadRequest } = require('vod-node-sdk');

client = new VodUploadClient("Credentials TmpSecretId", "Credentials TmpSecretKey", "Credentials Token");
let req = new VodUploadRequest();
req.MediaFilePath = "/data/file/Wildlife.mp4";
client.upload("ap-guangzhou", req, function (err, data) {
    if (err) {
        // 예외 처리
        console.log(err)
    } else {
        // 업로드 성공 후 정보 가져오기
        console.log(data.FileId);
        console.log(data.MediaUrl);
    }
});

어댑티브 비트스트림 파일 업로드

이 SDK가 업로드용으로 지원하는 어댑티브 비트스트림 형식에는 HLS 및 DASH가 포함되며, manifest(M3U8 또는 MPD)에서 참고하는 미디어 파일은 상대 경로여야 하고(즉, URL 및 절대 경로는 사용할 수 없음), manifest의 동일 레벨 디렉터리 또는 서브 디렉터리(예: ../는 사용할 수 없음)에 위치해야 합니다. SDK의 업로드 API를 호출할 때 MediaFilePath 매개변수로 manifest 경로를 입력하면 SDK가 관련 미디어 파일 목록을 파싱하여 함께 업로드합니다.
const { VodUploadClient, VodUploadRequest } = require('vod-node-sdk');

client = new VodUploadClient("your secretId", "your secretKey");
let req = new VodUploadRequest();
req.MediaFilePath = "/data/file/prog_index.m3u8";
client.upload("ap-guangzhou", req, function (err, data) {
    if (err) {
        // 예외 처리
        console.log(err)
    } else {
        // 업로드 성공 후 정보 가져오기
        console.log(data.FileId);
        console.log(data.MediaUrl);
    }
});

API 설명

업로드 클라이언트 클래스 VodUploadClient
속성 이름
속성 설명
유형
필수 입력
secretId
Tencent Cloud API 키 ID.
String
Yes
secretKey
Tencent Cloud API Key.
String
Yes
업로드 요청 클래스 VodUploadRequest
속성 이름
속성 설명
유형
필수 입력
MediaFilePath
업로드할 미디어 파일의 경로로, 로컬 경로(즉, 서버의 경로)여야 하며 URL을 지원하지 않습니다.
String
Yes
SubAppId
VOD의 서브 애플리케이션 ID입니다. 서브 애플리케이션의 리소스에 액세스하려면 이 필드에 서브 애플리케이션 ID를 입력하고, 그렇지 않으면 비워 둡니다.
Integer
No
MediaType
업로드할 미디어 파일의 유형입니다. 유효 값은 미디어 업로드 개요를 참고하십시오. MediaFilePath 경로에 파일 확장자가 포함된 경우 이 매개변수를 비워 둘 수 있습니다.
String
No
MediaName
업로드된 미디어 파일의 이름입니다. 이 매개변수를 비워 두면 기본적으로 MediaFilePath의 파일 이름이 사용됩니다.
String
No
CoverFilePath
업로드할 커버 파일의 경로로, 로컬 경로(즉, 서버의 경로)여야 하며 URL을 지원하지 않습니다.
String
No
CoverType
업로드할 커버 파일의 유형입니다. 유효한 값은 미디어 업로드 개요를 참고하십시오. CoverFilePath 경로에 파일 확장자가 포함되어 있으면 이 매개변수를 비워 둘 수 있습니다.
String
No
Procedure
업로드 완료 후 자동으로 실행될 태스크 플로우의 이름으로, 태스크 플로우(API 방식 또는 콘솔 방식)를 생성할 때 지정하는 매개변수입니다. 자세한 내용은 태스크 플로우를 참고하십시오.
String
No
ExpireTime
ISO 8601 형식의 미디어 파일 만료 시간으로, 자세한 내용은 ISO 날짜 형식을 참고하십시오.
String
No
ClassId
관리할 미디어를 분류하는 데 사용되는 클래스 ID로, CreateClass API를 사용하여 클래스를 생성하고, 클래스 ID를 얻을 수 있습니다.
Integer
No
SourceContext
최대 250자의 소스 컨텍스트로, 사용자 요청 정보를 전달하는 데 사용되며 업로드 콜백 API에서 반환됩니다.
String
No
StorageRegion
파일을 저장할 스토리지 리전입니다. 이 필드는 리전 영어 약칭을 입력합니다.
String
No
업로드 응답 클래스 VodUploadResponse
속성 이름
속성 설명
유형
FileId
미디어 파일의 고유 ID입니다.
String
MediaUrl
미디어 재생 주소입니다.
String
CoverUrl
미디어 커버 주소입니다.
String
RequestId
요청의 고유 ID입니다. 각 요청은 고유 ID를 반환합니다. RequestId는 문제를 해결하는 데 필요합니다.
String
업로드 메소드 VodUploadClient.upload(String region, VodUploadRequest request, function callback)
매개변수 이름
매개변수 설명
유형
필수 입력
region
VOD 서버를 요청하는 액세스 포인트 리전으로 스토리지 리전과 다릅니다. 자세한 내용은 지원 리전 리스트를 참고하십시오.
String
Yes
request
업로드 요청.
VodUploadRequest
Yes
callback
업로드 완료 콜백 함수.
function
Yes
업로드 완료 콜백 함수 function(err, data)
매개변수 이름
매개변수 설명
유형
필수 입력
err
오류 메시지.
Exception
Yes
data
응답 결과 업로드.
VodUploadResponse
Yes

오류 코드

상태 코드
의미
InternalError
내부 오류.
InvalidParameter.ExpireTime
잘못된 매개변수 값: 만료 시간.
InvalidParameterValue.CoverType
잘못된 매개변수 값: 커버 유형.
InvalidParameterValue.MediaType
잘못된 매개변수 값: 미디어 유형.
InvalidParameterValue.SubAppId
I잘못된 매개변수 값: 서브 애플리케이션 ID.
InvalidParameterValue.VodSessionKey
잘못된 매개변수 값: VOD 세션.
ResourceNotFound
리소스가 존재하지 않음.
이전 주제: Python SDK다음 주제: Go SDK

도움말 및 지원

문제 해결에 도움이 되었나요?

피드백