tencent cloud

Video on Demand

ドキュメントVideo on Demand開発ガイドメディアアップロードクライアントからのアップロードFlutter アップロード SDK

Flutter アップロード SDK

PDF
フォーカスモード
フォントサイズ
最終更新日: 2024-11-15 10:55:40
Flutter プラットフォームでビデオをアップロードするシナリオ向けに、VOD は Flutter アップロード SDKを提供しています。アップロード手順については、 クライアントからのアップロードガイドラインをご参照ください。
SDK 名
VOD の Flutter アップロード SDK
バージョン番号
V1.0.0
SDK の紹介
App のエンドユーザー向けにローカルビデオを VOD プラットフォームにアップロードするシナリオを提供
開発者
Tencent Cloud Computing (Beijing) Co., Ltd.
SDK をダウンロード
1. をクリックして Flutter アップロード SDK とソースコードをダウンロードします。ダウンロードされた圧縮ファイルを解凍すると、vod_upload ディレクトリが表示されます。
2. ソースコードは vod_upload/lib ディレクトリにアップロードされます。

環境準備

Flutter：
Flutter 2.5.0 及びそれ以降のバージョン。
Dart 2.19.2 及びそれ以降のバージョン但し 3.0 バージョン以下。
Android：
Android Studio 3.5 及びそれ以降のバージョン。
Android 4.1 及びそれ以降のバージョン本。
iOS：
Xcode 11.0 及びそれ以降のバージョン。
iOS 9.0 及びそれ以降のバージョン。
プロジェクトに有効な開発者署名が設定されていることを確認してください。

迅速な統合

依存を導入

1. SDK のソースコードをプロジェクトのディレクトリにコピーします。
2. pubspec.yamlで SDK を導入します。
vod_upload_flutter:
  path: ./vod_upload
3. プロジェクトのルートディレクトリで flutter pub get コマンドを実行して依存関係を更新します。
ご注意：
1. プロジェクトルートディレクトリ 、 SDK ディレクトリ 、 SDK Example ディレクトリ++ ++でそれぞれ++ ++flutter pub get` コマンドを実行するのが望ましいです。そうしないとエラーが発生する可能性があります。
2. SDK Exampleディレクトリ は SDK のテストプロジェクトです。必要がなければ削除できます。

ネイティブ設定を追加

Android

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

iOS の Info.plist に以下の設定を追加：
<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>
ご注意：
SDK に含まれる Demo を実行するには、アルバム使用権限も宣言する必要があります。

使用

1. ファイルのインポート。
import 'package:vod_upload_flutter/txugc_publish.dart';
2. オブジェクトの作成。
var uploader = TXUGCPublish(
    id: "",
);
ご注意：
id は任意の文字列に設定できます。 重複しない ことを確保すればよいです。主な目的は Flutter オブジェクトとネイティブレイヤーのオブジェクトをマッピングすることです。

関連 API

ビデオのアップロード

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);
ご注意：
プリアップロードは 静的メソッドです。

アップロード情報を取得

// Android 端末ではアップロード中のみ情報を取得できますが、iOS端 端末では全プロセスで情報を取得できます。
uploader.getStatusInfo();

AppId の報告

uploader.setAppId(appId);

ビデオアップロードコールバックの設定

uploader.setVideoListener(listener);

メディアアップロードコールバックの設定

uploader.setMediaListener(listener);

コールバックインターフェースおよびパラメータ説明

ビデオアップロードパラメータ

TXPublishParam
フィールド名
タイプ
必須かどうか
説明
デフォルト値
signature
string
はい
サイン
null
videoPath
string
はい
ビデオパス
null
fileName
string
はい
ファイル名
null
enableResume
boolean
いいえ
続行ポイントを有効にするかどうか
true
enableHttps
boolean
いいえ
https を有効にするかどうか
false
coverPath
string
いいえ
カバーピクチャー
null
enablePreparePublish
boolean
いいえ
プリアップロードを有効にするかどうか(無効にすると手動でプリアップロードできる)
true
sliceSize
integer
いいえ
シャードサイズ。
最小 1M、最大 10M に対応、デフォルトは 0。アップロードするファイルのサイズを 10 で割った値を表します。
0
concurrentCount
integer
いいえ
シャードアップロードの並行処理数(0 以下の場合、SDK 内部のデフォルト値 2 を使用する)。
-1

メディアアップロードパラメータ

TXMediaPublishParam
フィールド名
タイプ
必須かどうか
説明
デフォルト値
signature
string
はい
サイン
null
mediaPath
string
はい
视ビデオパス
null
fileName
string
はい
ファイル名
null
enableResume
boolean
いいえ
続行ポイントを有効にするかどうか
true
enableHttps
boolean
いいえ
https を有効にするかどうか
false
enablePreparePublish
boolean
いいえ
プリアップロードを有効にするかどうか（無効にするとにすると手動でアップロードできる)
true
sliceSize
integer
いいえ
シャードサイズ。
最小 1M、最大 10M に対応、デフォルトは 0。アップロードするファイルのサイズを 10 で割った値を表します。
0
concurrentCount
integer
いいえ
シャードアップロードの並行処理数(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
オンデマンドサーバーセッションキー値。アップロードリクエストインターフェースから取得します。
cosRegion
string
現在のアップロードによってアクセスされる地域
requestId
string
現在の COS アップロードリクエスト id
cosVideoPath
string
現在の COS ビデオアップロードパス
vodErrCode
integer
シグナルリクエストエラーコード
useHttpDNS
integer
httpDnsを使用してドメイン名を解析するかどうか
useCosAcc
integer
COSドメイン名加速を有効にしているかどうか
tcpConnTimeCost
integer
現在のステップでサーバー接続にかかった時間
recvRespTimeCost
integer
現在のステップでサーバー応答を受信するのにかかった時間

前の記事へ: iOSアップロードSDK次の記事へ: VCの概要

ヘルプとサポート

この記事はお役に立ちましたか？

フィードバック