Appearance

On this page

视频制作进度查询接口 ​

1.接口功能 ​

该功能允许用户通过千面动捕服务接口查看视频的制作进度。

2.请求方法 ​

WebSocket

3.请求路径 ​

wss://www.qmai.vip/progress

4.请求参数 ​

  • companyKey：必填，企业用户的上传凭证（可在用户详情页查看）。

  • videoId：必填，上传视频的ID，可在视频上传的返回获取，也可登录账号从网站获取。

5.响应信息 ​

服务端将以 JSON 格式返回响应数据。相应数据的格式为：

{
    'progress': 0,
    'status': 2
}
  • progress：制作进度
  • status：制作状态信息（1：待制作；2：制作中；3：制作完成）

6.python示例代码 ​

# encoding=utf-8
import configparser
import json
import threading
import time

import websocket

videoId = ''
key = ''

ws_url = f"wss://www.qmai.vip/progress?videoId={videoId}&companyKey={key}"


def on_message(ws, message):
    """处理接收到的消息"""
    try:
        data = json.loads(message)
        print(f"收到消息: {data}")
        if 'progress' in data:
            print(f"进度: {data['progress']}%")
        elif 'error' in data:
            print(f"错误: {data['error']}")
    except json.JSONDecodeError:
        print(f"收到非 JSON 消息: {message}")


def on_error(ws, error):
    print(f"发生错误: {error}")


def on_close(ws, close_status_code, close_msg):
    print(f"连接关闭: 状态码={close_status_code}, 原因={close_msg}")


def on_open(ws):
    print("WebSocket 连接已建立")


def run_websocket():
    ws = websocket.WebSocketApp(
        ws_url,
        on_open=on_open,
        on_message=on_message,
        on_error=on_error,
        on_close=on_close
    )

    ws.run_forever()


if __name__ == "__main__":
    ws_thread = threading.Thread(target=run_websocket)
    ws_thread.daemon = True
    ws_thread.start()

    try:
        while True:
            time.sleep(1)
    except KeyboardInterrupt:
        print("程序退出")

CopyRight © 2023 QMAI.VIP