tencent cloud

フィードバック

Flutter アップロード SDK

最終更新日: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.yamlSDK を導入します。
    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

    iOSInfo.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
    現在のステップでサーバー応答を受信するのにかかった時間
    
    お問い合わせ

    カスタマーサービスをご提供できるため、ぜひお気軽にお問い合わせくださいませ。

    テクニカルサポート

    さらにサポートが必要な場合は、サポートチケットを送信して弊社サポートチームにお問い合わせください。24時間365日のサポートをご提供します。

    電話サポート(24 時間365日対応)