릴리스 노트
SDK 이름 | VOD Flutter 업로드 SDK |
버전 번호 | V1.0.0 |
SDK 소개 | 앱의 최종 사용자가 로컬 비디오를 VOD 플랫폼에 업로드하는 시나리오를 제공합니다 |
개발자 | Tencent Cloud Computing (Beijing) Co., Ltd. |
SDK 다운로드 | 1. 다운로드하기를 클릭하여 Flutter 업로드 SDK 및 소스 코드를 다운로드하고, 다운로드된 압축 파일을 해제하면 vod_upload 디렉토리를 볼 수 있습니다. 2. 업로드 소스는 vod_upload/lib 디렉토리 아래에 있습니다. |
pubspec.yaml 에 SDK 를 추가하세요 .vod_upload_flutter: path: ./vod_upload
flutter pub get 명령어를 실행하여 종속성을 갱신하세요.프로젝트 루트 디렉토리 , SDK 디렉토리 , SDK Example 디렉토리 에서 각각 flutter pub get 명령어를 실행하세요, 그렇지 않으면 오류가 발생할 수 있습니다.SDK Example 디렉토리 는 SDK 의 테스트 프로젝트이므로 필요 없으면 삭제할 수 있습니다.AndroidManifest.xml 에 다음 구성을 추가하십시오:<!-- 네트워크 권한 --> <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
iOS 의 Info.plist 에 다음 구성을 추가하십시오:<key>NSAppTransportSecurity</key> <dict> <key>NSAllowsArbitraryLoads</key> <true/> </dict>
SDK 에서 제공하는 Demo 를 실행하려면, 앨범 사용 권한도 선언해야 합니다.import 'package:vod_upload_flutter/txugc_publish.dart';
var uploader = TXUGCPublish( id: "", );
id 는 Flutter 객체와 네이티브 계층 객체를 매핑하는 것이 주요 목적이므로, 중복되지 않도록 보장 할 수 있는 한 임의의 문자열로 설정할 수 있습니다.uploader.publishVideo(TXPublishParam( signature: "", videoPath: "", fileName: "", ));
uploader.cancelUploadVideo();
uploader.resumeUploadVideo(TXPublishParam( signature: "", videoPath: "", fileName: "", ));
uploader.publishMedia(TXMediaPublishParam( signature: "", mediaPath: "", fileName: "", ));
uploader.cancelUploadMedia();
uploader.resumeUploadMedia(TXMediaPublishParam( signature: "", mediaPath: "", fileName: "", ));
TXUGCPublish.prepareUpload(signature, callback);
// 안드로이드에서는 업로드 중에만 정보를 가져올 수 있고, iOS에서는 전체 과정에서 정보를 가져올 수 있습니다. uploader.getStatusInfo();
uploader.setAppId(appId);
uploader.setVideoListener(listener);
uploader.setMediaListener(listener);
TXPublishParam 필드명 | 유형 | 필수 여부 | 설명 | 기본값 |
signature | string | Yes | 서명 | null |
videoPath | string | Yes | 비디오 경로 | null |
fileName | string | Yes | 파일명 | null |
enableResume | boolean | No | 재개 기능 활성화 여부 | true |
enableHttps | boolean | No | https 활성화 여부 | false |
coverPath | string | No | 커버 이미지 | null |
enablePreparePublish | boolean | No | 사전 업로드 활성화 여부 (비활성화 시 수동으로 사전 업로드 가능) | true |
sliceSize | integer | No | 분할 크기. 최소 1M, 최대 10M 까지 지원하며, 기본값 0은 업로드 파일 크기를 10 으로 나눈 값을 의미합니다. | 0 |
concurrentCount | integer | No | 분할 업로드 동시 실행 수(≤ 0인 경우 SDK 의 내부 기본값 2를 사용). | -1 |
TXMediaPublishParam 필드명 | 유형 | 필수 여부 | 설명 | 기본값 |
signature | string | Yes | 서명 | null |
mediaPath | string | Yes | 비디오 경로 | null |
fileName | string | Yes | 파일명 | null |
enableResume | boolean | No | 재개 기능 활성화 여부 | true |
enableHttps | boolean | No | https 활성화 여부 | false |
enablePreparePublish | boolean | No | 사전 업로드 활성화 여부 (비활성화 시 수동으로 사전 업로드 가능) | true |
sliceSize | integer | No | 분할 크기. 최소 1M, 최대 10M 까지 지원하며, 기본값 0은 업로드 파일 크기를 10 으로 나눈 값을 의미합니다. | 0 |
concurrentCount | integer | No | 분할 업로드 동시 실행 수(≤ 0인 경우 SDK 의 내부 기본값 2를 사용). | -1 |
ITXVideoPublishListener 메서드명 | 매개변수 | 설명 |
onPublishProgress | void | 업로드 진행 콜백 |
onPublishComplete | void | 업로드 완료 콜백 |
onPublishProgress 메서드명 | 매개변수 | 설명 |
uploadBytes | integer | 업로드한 바이트 수 |
totalBytes | integer | 총 바이트 수 |
onPublishComplete 메서드명 | 매개변수 | 설명 |
result | TXPublishResult | 업로드 결과 |
TXPublishResult 필드명 | 매개변수 | 설명 |
retCode | integer | 오류 코드 |
descMsg | string | 오류 설명 정보 |
videoId | string | 비디오 파일 Id |
videoURL | string | 비디오 재생 주소 |
coverURL | string | 커버 저장 주소 |
ITXMediaPublishListener 메소드명 | 파라미터 | 설명 |
onMediaPublishProgress | void | 업로드 진행 콜백 |
onMediaPublishComplete | void | 업로드 완료 콜백 |
onMediaPublishProgress 파라미터 이름 | 유형 | 설명 |
uploadBytes | integer | 업로드된 바이트 수 |
totalBytes | integer | 총 바이트 수 |
onMediaPublishComplete 파라미터 이름 | 유형 | 설명 |
result | TXPublishResult | 업로드 결과 |
TXMediaPublishResult 필드 이름 | 유형 | 설명 |
retCode | integer | 오류 코드 |
descMsg | string | 오류 설명 정보 |
mediaId | string | 비디오 파일 Id |
mediaURL | string | 비디오 재생 주소 |
IPrepareUploadCallback메서드 명 | 반환 값 | 설명 |
onLoading | void | 사전 업로드 콜백 시작 |
onFinish | void | 사전 업로드 완료 콜백 |
ReportInfo 필드 이름 | 유형 | 설명 |
reqType | string | 요청 유형, 어떤 단계에서인지 표시합니다. |
errCode | string | 오류 코드 |
cosErrCode | string | COS 업로드 오류 코드 |
errMsg | string | 오류 정보 |
reqTime | string | 현재 단계의 시작 시간 |
reqTimeCost | string | 현재 단계의 소요 시간 |
fileSize | string | 파일 크기 |
fileType | string | 파일 유형 |
fileName | string | 파일명 |
fileId | string | 파일 Id |
appId | string | TXUGCPublish를 사용하여 설정된 VOD appId |
reqServerIp | string | 현재 진행 중인 단계의 접속 IP |
reportId | string | 고객 맞춤 보고 ID, TXUGCPublish 생성자 메서드로 전달 가능합니다. |
reqKey | string | 요청 키 값, 주로 파일 마지막 수정 시간과 이번 업로드 시작 시간으로 구성됨. |
vodSessionKey | string | VOD 서버 세션 키 값, 업로드 요청 인터페이스에서 얻음. |
cosRegion | string | 현재 업로드에 접근한 지역 |
requestId | string | 현재 COS 업로드 요청 ID |
cosVideoPath | string | 현재 COS 비디오 업로드 경로 |
vodErrCode | integer | 시그널 요청 오류 코드 |
useHttpDNS | integer | httpDns를 사용하여 도메인 이름을 해석할지 여부 |
useCosAcc | integer | COS 도메인 가속이 활성화되었는지 여부 |
tcpConnTimeCost | integer | 현재 단계의 서버 연결 소요 시간 |
recvRespTimeCost | integer | 현재 단계의 서버 응답 소요 시간 |
피드백