シナリオ1:オンデマンドファイルの品質検査
方法1:コンソールからタスクを開始
ステップ1:オンデマンドサービスワークフローの作成
2. ノードを追加すると新しいページが表示されます。そのページで、ビジネスの実際のシナリオに応じてシステムのプリセットテンプレートを選択するか、カスタムテンプレートを作成し、設定を保存します。
3. ノード設定完了後、ページ下部の作成をクリックし、サービスワークフローの作成を完了します。
4. サービスワークフロー作成後、オンデマンドサービスワークフローのリストページに戻ります。リストページで作成したワークフローを見つけ、「有効化」をクリックします。ボタンをオンにしてから約3~5分でワークフローが有効になります。
ステップ2:オンデマンド品質検査タスクの開始
サービスワークフローが有効になった後、ワークフローで設定したトリガーディレクトリに品質検査が必要なオンデマンドファイルをアップロードします。アップロードされたファイルは、ワークフローのノードとテンプレートの設定内容に従って品質検査が実行されます。
ステップ3:オンデマンド品質検査タスクの管理
方法2:APIを呼び出して処理
ステップ1:オンデマンド品質検査タスクの開始
ビデオURLまたはCOS内のメディアファイルに対して処理タスクを開始します。APIドキュメントメディア処理をご参照ください。 リクエスト例:
POST / HTTP/1.1
Host: mps.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: ProcessMedia
{
"InputInfo": {
"Type": "COS",
"CosInputInfo": {
"Bucket": "test-<appid>",
"Region": "ap-shanghai",
"Object": "/video/test.mp4"
}
},
"AiQualityControlTask": {
"Definition": 10
}
}
サンプルの説明:
1. TypeはCOSまたはURLが指定でき、タイプに応じてソースファイルのパスを記入します。
2. Definitionはタスク設定のテンプレートIDで、テンプレートはCreateQualityControlTemplateで生成します。
レスポンス例:
{
"Response": {
"TaskId": "26000002-ScheduleTask-8c0bb3a13e10462fc405262c623aeff4tt7"
}
}
サンプル説明:TaskIdはタスクを一意に識別するIDで、タスクの照会や管理に使用できます。
ステップ2:タスク詳細の照会
タスクIDを使用して、タスクの実行ステータスと結果の詳細情報を照会します。APIドキュメントタスク詳細の照会をご参照ください。 リクエスト例:
POST / HTTP/1.1
Host: mps.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeTaskDetail
{
"TaskId": "26000002-ScheduleTask-8c0bb3a13e10462fc405262c623aeff4tt7"
}
レスポンス例:
{
"Response": {
"WorkflowTask": {
"Output": {
"QualityControlResultSet": [
{
"Type": "BackWhiteEdge",
"QualityControlItems": [
{
"Confidence": 100,
"StartTimeOffset": 12,
"EndTimeOffset": 12
}
]
}
],
"ContainerDiagnoseResultSet": [
{
"Category": "StreamAbnormalCharacteristics",
"DateTimeSet": [],
"SeverityLevel": "Warning",
"TimestampSet": [
11.006
],
"Type": "AudioDuplicatedFrame"
}
],
"QualityEvaluationScore": 68
}
}
}
}
品質検査結果の表示
品質検査レポート
品質検査レポートは、検査結果を完全に表示するもので、ビデオの基本情報やプレビューが確認できます。対応する検査項目を有効にすると、各問題の発生回数やビデオ全体のスコアも表示されます。
ビデオの品質検査で問題が検出された場合、各問題が発生した時間帯が表示されます。タイムラインをクリックすると、対応するビデオクリップにジャンプして具体的な問題を確認できます。
品質検査の問題リストページでは、各問題が報告された具体的な時間を確認でき、問題のさらなる特定と分析に役立ちます。
シナリオ2:ライブストリームの品質検査
方法1:コンソールからタスクを開始
ステップ1:ライブ配信サービスワークフローの作成
2. ノードを追加すると新しいページが表示されます。そのページで、ビジネスの実際のシナリオに応じてシステムのプリセットテンプレートを選択するか、カスタムテンプレートを作成し、設定を保存します。
3. ノード設定完了後、ページ下部の作成をクリックし、サービスワークフローの作成を完了します。
4. サービスワークフロー作成後、ライブ配信サービスワークフローのリストページに戻ります。リストページで作成したライブ配信サービスワークフローを確認できます。
ステップ2:ライブ配信品質検査タスクの作成
ライブ配信タスク管理に移動し、タスク作成をクリックします。作成ページで処理したいライブストリームのアドレスを入力し、前のステップで作成したライブ配信サービスワークフローを選択します(その他の設定はビジネス要件に応じて入力)。作成をクリックして完了です。 ステップ3:ライブ配信品質検査タスクの管理
方法2:APIを呼び出して処理
ステップ1:ライブ配信品質検査タスクの開始
リクエスト例:
POST / HTTP/1.1
Host: mps.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: ProcessLiveStream
{
"Url": "rtmp://tlivecloud.com/live/test",
"TaskNotifyConfig": {
"NotifyType": "URL",
"NotifyUrl": "http://tlivecloud.com/callback"
},
"AiQualityControlTask": {
"Definition": 10
}
}
サンプルの説明:
1. Url はライブストリームのアドレスです。
2. TaskNotifyConfig はコールバックサービスのアドレスです。ビデオストリームで異常が検出された際、その情報がこのアドレスにリアルタイムでコールバックされます。
レスポンス例:
{
"Response": {
"TaskId": "24000002-live-procedure-813dc41e6fdc22dcf24aa6e9c61cp92"
}
}
サンプル説明:TaskIdはタスクを一意に識別するIDで、タスクの照会や管理に使用できます。
ステップ2:ライブ配信の異常検知コールバックの解析
メッセージを受信後、メッセージのmsgBodyフィールドからMPSライブストリーム処理イベント通知の内容を解析します。APIドキュメントライブストリーム処理結果の解析をご参照ください。 ライブ配信品質検査タスクを開始する際にTaskNotifyConfigが設定されていると、ビデオストリームで異常が検出された際、その情報が設定されたアドレスにリアルタイムでコールバックされます。
コールバックリクエストの例:
POST / HTTP/1.1
Content-Type: application/json
{
"NotificationType": "AiQualityControlResult",
"TaskId": "24000002-procedure-live-813dc41e6fdc22dcf24aa6e9c61cp92",
"AiQualityControlResultInfo": {
"QualityControlResultSet": [
{
"Type": "BackWhiteEdge",
"QualityControlItems": [
{
"Confidence": 100,
"StartTimeOffset": 12,
"EndTimeOffset": 12
}
]
}
],
"DiagnoseResultSet": [
{
"Category": "StreamStatusException",
"Type": "StreamOpenFailed",
"Timestamp": 0,
"Description": "Open url failed.",
"DateTime": "2023-11-06T06:37:28Z",
"SeverityLevel": "Fatal"
}
]
}
}
サンプルの説明:QualityControlResultSetは内容の品質検査に関する異常情報、DiagnoseResultSetはフォーマット診断に関する異常情報です。