機能概要
本機能は、動画ファイルをトランスコードすることなく、MP4形式の配信ファイルとして登録
する機能です。登録にはWriteAPIを使用します。
WriteAPIの『upload』APIに特定パラメーターを付与し、画質番号を設定していただいたうえで、
アップロードしていただきます。
■APIリンク書式
https://file-platform.stream.co.jp/writeapi/upload/[アップロードキー]
■プロトコル
https (UTF-8)
(POST：multipart/form-data)
■引数
|
項目名 |
必須 |
説明 |
デフォルト値 |
フォーマット |
|
overwritemp4 |
○ |
画質指定 |
--- |
1:低画質、2:標準画質、3:高画質、4:HD画質、5:フルHD画質 |
※動画登録時、EQシステムで必要な情報として、以下の情報を取得します。
情報の取得ができなかった場合は登録処理エラーとなります。
・ファイル形式
・動画サイズ(縦横)
・ビットレート
・動画の長さ
・ファイルサイズ
|
項目 |
必須 |
内容 |
補足事項 |
|
動画コンテンツ |
○ |
MP4 |
映像コーデック：H.264 音声コーデック：AAC, AAC-LC |
|
画質設定 |
○ |
1:低画質、2:標準画質、3:高画質、4:HD画質、5:フルHD画質 |
|
|
動画ID |
--- |
自動採番 |
|
|
サムネイル |
--- |
縦240px以上 |
サムネイル未選択時は、黒いサムネイルが生成されます。 対応拡張子：jpg、gif、png |
※本機能で既にアップロードして頂いたコンテンツの動画IDをパラメータに指定し、動画ファ
イルをアップロードされた際、既に同じ画質の動画が存在していた場合は、アップロードし
た動画に差し替わります。別画質をアップロードした場合は、新しく画質が追加されます。
|
// 動画アップロードAPIのパラメータ設定 $postfields = array( // 動画ファイル名 "movie" => "@".$filepath.";type=application/octet-stream;filename=".$filename, // サムネイルファイル名 "thumb" => "@".$thumbpath.";type=application/octet-stream;filename=".$thumbname, // 動画タイトル "title" => "サンプル動画タイトル",
// 標準画質 "overwritemp4" => "2" |
■制限事項
・管理画面からのバイパスアップロードは対応しておりません。
・本機能はトランスコードが発生しませんので、callbackパラメーターはご利用いただけません。
・「overwritemp4」パラメーターを使用しない場合は通常の動画アップロードとして扱われ、
トランスコード機能により配信用ファイルが生成されます。
・HLS配信用ファイルは、バイパスアップロードには対応しておりません。
※PD配信アカウントに関する注意事項
・PD配信をご利用されている場合、PD配信の特性上、配信されるすべてのMP4ファイルはWEB公開領域に配置されます。そのため、初期利用時のみバイパスアップロードを行い、以降は管理画面等からの動画アップロードをされた場合でも、すべてのMP4ファイルに公開リスクが生じます。