{"id":396,"date":"2026-03-06T09:49:42","date_gmt":"2026-03-06T01:49:42","guid":{"rendered":"https:\/\/www.liaoxinghui.com\/?p=396"},"modified":"2026-03-06T09:49:42","modified_gmt":"2026-03-06T01:49:42","slug":"freeswitch-lua-recording-transcription-storage","status":"publish","type":"post","link":"https:\/\/www.liaoxinghui.com\/?p=396","title":{"rendered":"\u4f7f\u7528Lua\u811a\u672c\u5b9e\u73b0FreeSWITCH\u901a\u8bdd\u5f55\u97f3\u81ea\u52a8\u8f6c\u5199\u4e0e\u5b58\u50a8"},"content":{"rendered":"

\u4f7f\u7528Lua\u811a\u672c\u5b9e\u73b0FreeSWITCH\u901a\u8bdd\u5f55\u97f3\u81ea\u52a8\u8f6c\u5199\u4e0e\u5b58\u50a8<\/h1>\n

1. \u4e1a\u52a1\u573a\u666f\u4e0e\u76ee\u6807<\/h2>\n

\u5ba2\u670d\u4e2d\u5fc3\u901a\u8bdd\u5f55\u97f3\u540e\uff0c\u9700\u8981\u81ea\u52a8\u8f6c\u5199\u4e3a\u6587\u672c\uff0c\u5b58\u50a8\u5230\u6570\u636e\u5e93\u4f9b\u8d28\u68c0\u5206\u6790\u3002\u76ee\u6807\uff1a\u5728FreeSWITCH\u901a\u8bdd\u7ed3\u675f\u65f6\uff0c\u81ea\u52a8\u89e6\u53d1\u5f55\u97f3\u8f6c\u5199\uff0c\u5c06\u5f55\u97f3\u6587\u4ef6\u8def\u5f84\u3001\u8f6c\u5199\u6587\u672c\u3001\u65f6\u95f4\u6233\u7b49\u5b58\u5165MySQL\uff0c\u5b9e\u73b0\u7aef\u5230\u7aef\u81ea\u52a8\u5316\u3002<\/p>\n

2. \u73af\u5883\u51c6\u5907\uff08uv + \u4f9d\u8d56\uff09<\/h2>\n

\u4f7f\u7528uv\u7ba1\u7406Python\u73af\u5883\uff0c\u786e\u4fddFreeSWITCH\u5df2\u5b89\u88c5Lua\u6a21\u5757\u3002<\/p>\n

# \u5b89\u88c5uv\uff08\u5982\u672a\u5b89\u88c5\uff09\ncurl -LsSf https:\/\/astral.sh\/uv\/install.sh | sh\n# \u521b\u5efa\u9879\u76ee\u76ee\u5f55\nmkdir freeswitch_transcription && cd freeswitch_transcription\n# \u521d\u59cb\u5316uv\u73af\u5883\nuv venv\nsource .venv\/bin\/activate  # Linux\/Mac\n# \u5b89\u88c5\u4f9d\u8d56\nuv add fastapi uvicorn pydantic requests pymysql openai-whisper torch\n# FreeSWITCH\u9700\u786e\u4fddLua\u652f\u6301\uff0c\u68c0\u67e5\/usr\/local\/freeswitch\/scripts\/\u76ee\u5f55<\/code><\/pre>\n
3. \u6570\u636e\u8bf4\u660e\uff08\u771f\u5b9e\u6570\u636e\u53e3\u5f84\u6216\u6a21\u62df\u6570\u636e\u751f\u6210\u903b\u8f91\uff09<\/h2>\n
    \n
  • \u5f55\u97f3\u6570\u636e\uff1aFreeSWITCH\u751f\u6210\u7684.wav\u6587\u4ef6\uff0c\u901a\u5e38\u4f4d\u4e8e\/var\/lib\/freeswitch\/recordings\/\uff0c\u6587\u4ef6\u540d\u5982${uuid}.wav\u3002<\/li>\n
  • \u8f6c\u5199\u6587\u672c\uff1a\u4f7f\u7528Whisper\u6a21\u578b\u5c06.wav\u6587\u4ef6\u8f6c\u5199\u4e3a\u4e2d\u6587\u6216\u82f1\u6587\u6587\u672c\u3002<\/li>\n
  • \u5b58\u50a8\u5b57\u6bb5\uff1a\u5f55\u97f3\u6587\u4ef6\u8def\u5f84\u3001\u8f6c\u5199\u6587\u672c\u3001\u901a\u8bdd\u552f\u4e00\u6807\u8bc6\uff08UUID\uff09\u3001\u5f00\u59cb\u65f6\u95f4\u3001\u7ed3\u675f\u65f6\u95f4\u3001\u8f6c\u5199\u72b6\u6001\uff08\u6210\u529f\/\u5931\u8d25\uff09\u3002<\/li>\n
  • \u6a21\u62df\u6570\u636e\uff1a\u53ef\u7528ffmpeg\u751f\u6210\u6d4b\u8bd5.wav\u6587\u4ef6\uff1affmpeg -f lavfi -i sine=frequency=1000:duration=5 -ac 2 test.wav<\/code>\u3002<\/li>\n<\/ul>\n
    4. \u8bad\u7ec3\/\u5b9e\u73b0\u6b65\u9aa4\uff08\u5b8c\u6574\u4ee3\u7801\uff09<\/h2>\n
    \u4efb\u52a1\u7c7b\u578b\uff1a<\/strong> \u8bed\u97f3\u8f6c\u5199\uff08\u5e8f\u5217\u5230\u5e8f\u5217\u4efb\u52a1\uff0c\u4f46\u672c\u6587\u805a\u7126\u5de5\u7a0b\u96c6\u6210\uff0c\u4e0d\u6d89\u53ca\u6a21\u578b\u8bad\u7ec3\uff09\u3002<\/p>\n
    \u6b65\u9aa41\uff1a\u521b\u5efaPython\u8f6c\u5199\u670d\u52a1\uff08app.py\uff09<\/strong><\/p>\n
    from fastapi import FastAPI, HTTPException\nfrom pydantic import BaseModel\nimport subprocess\nimport os\nimport pymysql\nfrom datetime import datetime\nimport logging\n\nlogging.basicConfig(level=logging.INFO)\napp = FastAPI()\n\n# \u6570\u636e\u5e93\u914d\u7f6e\uff08\u793a\u4f8b\uff0c\u9700\u66ff\u6362\u4e3a\u5b9e\u9645\u503c\uff09\nDB_CONFIG = {\n    'host': 'localhost',\n    'user': 'root',\n    'password': 'password',\n    'database': 'call_records',\n    'charset': 'utf8mb4'\n}\n\nclass TranscriptionRequest(BaseModel):\n    file_path: str\n    call_uuid: str\n    start_time: str\n    end_time: str\n\n@app.post("\/transcribe")\nasync def transcribe_audio(request: TranscriptionRequest):\n    """\u63a5\u6536\u5f55\u97f3\u6587\u4ef6\u8def\u5f84\uff0c\u8c03\u7528Whisper\u8f6c\u5199\uff0c\u7ed3\u679c\u5b58\u5165\u6570\u636e\u5e93"""\n    file_path = request.file_path\n    if not os.path.exists(file_path):\n        raise HTTPException(status_code=404, detail="File not found")\n\n    # \u4f7f\u7528Whisper\u547d\u4ee4\u884c\u8f6c\u5199\uff08\u786e\u4fddwhisper\u5df2\u5b89\u88c5\uff1auv add openai-whisper\uff09\n    try:\n        # \u8f6c\u5199\u4e3a\u4e2d\u6587\uff0c\u53ef\u8c03\u6574\u6a21\u578b\uff08\u5982base\u3001small\uff09\n        result = subprocess.run(\n            ["whisper", file_path, "--language", "Chinese", "--model", "base"],\n            capture_output=True,\n            text=True,\n            timeout=30  # \u8d85\u65f6\u8bbe\u7f6e\uff0c\u907f\u514d\u5927\u6587\u4ef6\u5361\u6b7b\n        )\n        if result.returncode != 0:\n            raise Exception(f"Whisper failed: {result.stderr}")\n        # \u89e3\u6790\u8f93\u51fa\uff0c\u83b7\u53d6\u8f6c\u5199\u6587\u672c\uff08\u7b80\u5316\u5904\u7406\uff0c\u5b9e\u9645\u9700\u89e3\u6790\u6587\u4ef6\uff09\n        transcription_text = result.stdout.split('\\n')[0] if result.stdout else ""\n    except subprocess.TimeoutExpired:\n        transcription_text = "\u8f6c\u5199\u8d85\u65f6"\n        logging.error(f"Transcription timeout for {file_path}")\n    except Exception as e:\n        transcription_text = f"\u8f6c\u5199\u5931\u8d25: {str(e)}"\n        logging.error(f"Transcription error: {e}")\n\n    # \u5b58\u50a8\u5230MySQL\n    conn = pymysql.connect(**DB_CONFIG)\n    cursor = conn.cursor()\n    try:\n        sql = """\n        INSERT INTO transcriptions (call_uuid, file_path, transcription, start_time, end_time, status)\n        VALUES (%s, %s, %s, %s, %s, %s)\n        """\n        status = "success" if "\u8f6c\u5199" not in transcription_text else "failed"\n        cursor.execute(sql, (request.call_uuid, file_path, transcription_text,\n                             request.start_time, request.end_time, status))\n        conn.commit()\n    except Exception as e:\n        logging.error(f"Database error: {e}")\n        conn.rollback()\n    finally:\n        cursor.close()\n        conn.close()\n\n    return {"call_uuid": request.call_uuid, "transcription": transcription_text, "status": "processed"}\n\nif __name__ == "__main__":\n    import uvicorn\n    uvicorn.run(app, host="0.0.0.0", port=8000)<\/code><\/pre>\n
    \u6b65\u9aa42\uff1a\u521b\u5efaLua\u811a\u672c\uff08\/usr\/local\/freeswitch\/scripts\/transcribe.lua\uff09<\/strong><\/p>\n
    -- transcribe.lua\n-- FreeSWITCH Lua\u811a\u672c\uff0c\u5728\u901a\u8bdd\u7ed3\u675f\u65f6\u89e6\u53d1\u8f6c\u5199\n\nlocal log = require "log"\n\n-- \u914d\u7f6e\u8f6c\u5199\u670d\u52a1URL\nlocal transcription_service_url = "http:\/\/localhost:8000\/transcribe"\n\nfunction transcribe(session)\n    local uuid = session:getVariable("uuid")\n    local start_time = session:getVariable("start_stamp")\n    local end_time = os.date("%Y-%m-%d %H:%M:%S")\n    local recording_path = session:getVariable("record_path")\n\n    if not recording_path then\n        log.err("No recording path found for UUID: " .. uuid)\n        return\n    end\n\n    -- \u6784\u5efaHTTP\u8bf7\u6c42\n    local json_body = string.format(\n        '{"file_path": "%s", "call_uuid": "%s", "start_time": "%s", "end_time": "%s"}',\n        recording_path, uuid, start_time, end_time\n    )\n\n    local http = require "socket.http"\n    local ltn12 = require "ltn12"\n    local response_body = {}\n\n    local res, code, headers, status = http.request{\n        url = transcription_service_url,\n        method = "POST",\n        headers = {\n            ["Content-Type"] = "application\/json",\n            ["Content-Length"] = tostring(#json_body)\n        },\n        source = ltn12.source.string(json_body),\n        sink = ltn12.sink.table(response_body)\n    }\n\n    if code == 200 then\n        log.info("Transcription triggered for UUID: " .. uuid)\n    else\n        log.err("Failed to trigger transcription for UUID: " .. uuid .. ", code: " .. tostring(code))\n    end\nend\n\n-- \u5728FreeSWITCH\u62e8\u53f7\u8ba1\u5212\u4e2d\u8c03\u7528\uff1aaction(lua transcribe.lua transcribe)\nreturn transcribe<\/code><\/pre>\n
    \u6b65\u9aa43\uff1a\u521b\u5efa\u6570\u636e\u5e93\u8868\uff08MySQL\uff09<\/strong><\/p>\n
    CREATE DATABASE IF NOT EXISTS call_records;\nUSE call_records;\n\nCREATE TABLE transcriptions (\n    id INT AUTO_INCREMENT PRIMARY KEY,\n    call_uuid VARCHAR(255) NOT NULL,\n    file_path VARCHAR(500) NOT NULL,\n    transcription TEXT,\n    start_time DATETIME,\n    end_time DATETIME,\n    status VARCHAR(50) DEFAULT 'pending',\n    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n    INDEX idx_uuid (call_uuid),\n    INDEX idx_status (status)\n) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;<\/code><\/pre>\n
    5. \u8c03\u7528\u65b9\u5f0f\uff08\u79bb\u7ebf\u6279\u91cf + \u5355\u6761\u793a\u4f8b\uff0c\u81f3\u5c11\u4e00\u79cd\uff09<\/h2>\n
      \n
    • \u5355\u6761\u793a\u4f8b\uff1a<\/strong> \u5728FreeSWITCH\u62e8\u53f7\u8ba1\u5212\u4e2d\uff0c\u901a\u8bdd\u7ed3\u675f\u540e\u8c03\u7528Lua\u811a\u672c\u3002\n
      <!-- \u5728conf\/dialplan\/default.xml\u4e2d\u6dfb\u52a0 -->\n<extension name="transcribe_after_call">\n  <condition field="destination_number" expression="^.*$">\n    <action application="lua" data="transcribe.lua transcribe"\/>\n  <\/condition>\n<\/extension><\/code><\/pre>\n
      \u901a\u8bdd\u7ed3\u675f\u65f6\uff0c\u81ea\u52a8\u6267\u884ctranscribe\u51fd\u6570\uff0c\u53d1\u9001\u5f55\u97f3\u4fe1\u606f\u5230Python\u670d\u52a1\u3002<\/p><\/li>\n
    • \u79bb\u7ebf\u6279\u91cf\uff1a<\/strong> \u76f4\u63a5\u8c03\u7528Python\u670d\u52a1API\u5904\u7406\u5386\u53f2\u5f55\u97f3\u6587\u4ef6\u3002\n
      curl -X POST http:\/\/localhost:8000\/transcribe \\\n  -H "Content-Type: application\/json" \\\n  -d '{"file_path": "\/path\/to\/recording.wav", "call_uuid": "test123", "start_time": "2023-10-01 10:00:00", "end_time": "2023-10-01 10:05:00"}'<\/code><\/pre><\/li>\n<\/ul>\n
      6. \u6307\u6807\u8bf4\u660e<\/h2>\n
      \u672c\u6587\u4efb\u52a1\u4e3a\u8bed\u97f3\u8f6c\u5199\uff0c\u5c5e\u5e8f\u5217\u751f\u6210\uff0c\u5e38\u7528\u6307\u6807\u4e3a\u8bcd\u9519\u8bef\u7387\uff08WER, Word Error Rate\uff09\uff0c\u4f46\u5de5\u7a0b\u96c6\u6210\u4e2d\u66f4\u5173\u6ce8\u53ef\u7528\u6027\u6307\u6807\uff1a<\/p>\n
        \n
      • \u8f6c\u5199\u6210\u529f\u7387\uff1a<\/strong> \u6210\u529f\u8f6c\u5199\u6b21\u6570 \/ \u603b\u8c03\u7528\u6b21\u6570\uff0c\u76f4\u63a5\u53cd\u6620\u670d\u52a1\u7a33\u5b9a\u6027\uff0c\u76ee\u6807 >95%\u3002<\/li>\n
      • \u5e73\u5747\u8f6c\u5199\u5ef6\u8fdf\uff1a<\/strong> \u4ece\u8c03\u7528\u5230\u5b8c\u6210\u7684\u65f6\u95f4\uff0c\u5f71\u54cd\u5b9e\u65f6\u6027\uff0c\u5ba2\u670d\u573a\u666f\u5efa\u8bae <30\u79d2\u3002<\/li>\n
      • \u5b58\u50a8\u6210\u529f\u7387\uff1a<\/strong> \u6570\u636e\u6210\u529f\u5b58\u5165\u6570\u636e\u5e93\u7684\u6bd4\u4f8b\uff0c\u786e\u4fdd\u6570\u636e\u4e0d\u4e22\u5931\u3002<\/li>\n<\/ul>\n
        7. \u4e0a\u7ebf\u540e\u8bc4\u4f30\uff08\u79bb\u7ebf\u76d1\u63a7\u3001\u7ebf\u4e0a\u6307\u6807\u3001\u91cd\u8bad\u89e6\u53d1\u6761\u4ef6\uff09<\/h2>\n
          \n
        • \u79bb\u7ebf\u76d1\u63a7\uff1a<\/strong> \u65e5\u5fd7\u5206\u6790\u8f6c\u5199\u5931\u8d25\u539f\u56e0\uff08\u5982\u6587\u4ef6\u7f3a\u5931\u3001Whisper\u8d85\u65f6\uff09\uff0c\u6570\u636e\u5e93\u68c0\u67e5\u6570\u636e\u5b8c\u6574\u6027\u3002<\/li>\n
        • \u7ebf\u4e0a\u6307\u6807\uff1a<\/strong> \u76d1\u63a7\u8f6c\u5199\u670d\u52a1HTTP\u54cd\u5e94\u7801\uff08200\u6bd4\u4f8b\uff09\u3001\u5e73\u5747\u54cd\u5e94\u65f6\u95f4\u3001MySQL\u8fde\u63a5\u6c60\u72b6\u6001\u3002<\/li>\n<\/ul>\n
          8. \u5e38\u89c1\u5751\u4e0e\u6392\u67e5<\/h2>\n
            \n
          1. \u5f55\u97f3\u6587\u4ef6\u8fc7\u5927\u5904\u7406\u8d85\u65f6\uff1a<\/strong> Whisper\u8f6c\u5199\u5927\u6587\u4ef6\u53ef\u80fd\u8d85\u65f6\uff1b\u5728Python\u670d\u52a1\u4e2d\u8bbe\u7f6esubprocess\u8d85\u65f6\uff08\u5982\u4ee3\u7801\u4e2dtimeout=30\uff09\uff0c\u5e76\u76d1\u63a7\u6587\u4ef6\u5927\u5c0f\uff0c\u8d85\u8fc7\u9608\u503c\uff08\u5982100MB\uff09\u5148\u538b\u7f29\u6216\u5206\u7247\u3002<\/li>\n
          2. \u8f6c\u5199\u670d\u52a1\u6545\u969c\u5bfc\u81f4\u6570\u636e\u4e22\u5931\uff1a<\/strong> Lua\u811a\u672cHTTP\u8bf7\u6c42\u5931\u8d25\u65f6\uff0c\u8bb0\u5f55\u9519\u8bef\u65e5\u5fd7\uff1b\u53ef\u6dfb\u52a0\u91cd\u8bd5\u673a\u5236\u6216\u6d88\u606f\u961f\u5217\uff08\u5982Redis\uff09\u7f13\u51b2\u8bf7\u6c42\u3002<\/li>\n
          3. Lua\u811a\u672c\u6027\u80fd\u74f6\u9888\uff1a<\/strong> \u540c\u6b65HTTP\u8c03\u7528\u963b\u585eFreeSWITCH\uff1b\u6539\u4e3a\u5f02\u6b65\uff08\u5982\u901a\u8fc7event socket\u53d1\u9001\u4e8b\u4ef6\u5230\u5916\u90e8\u670d\u52a1\uff09\uff0c\u6216\u9650\u5236\u5e76\u53d1\u8c03\u7528\u6570\u3002<\/li>\n
          4. \u6570\u636e\u5e93\u8fde\u63a5\u6cc4\u9732\uff1a<\/strong> \u786e\u4fddPython\u670d\u52a1\u4e2d\u6bcf\u6b21\u6570\u636e\u5e93\u64cd\u4f5c\u540e\u5173\u95ed\u8fde\u63a5\uff08\u4f7f\u7528try-finally\uff09\u3002<\/li>\n
          5. \u8def\u5f84\u6743\u9650\u95ee\u9898\uff1a<\/strong> \u786e\u4fddFreeSWITCH\u7528\u6237\u6709\u6743\u9650\u8bfb\u53d6\u5f55\u97f3\u6587\u4ef6\uff0cPython\u670d\u52a1\u6709\u6743\u9650\u5199\u5165\u6570\u636e\u5e93\u3002<\/li>\n<\/ol>","protected":false},"excerpt":{"rendered":"
            \u672c\u6587\u624b\u628a\u624b\u6559\u4f60\u7528Lua\u811a\u672c\u5728FreeSWITCH\u4e2d\u5b9e\u73b0\u901a\u8bdd\u5f55\u97f3\u81ea\u52a8\u8f6c\u5199\u4e3a\u6587\u672c\uff0c\u5e76\u5b58\u50a8\u5230MySQL\u6570\u636e\u5e93\uff0c\u9002\u7528\u4e8e\u5ba2\u670d\u8d28\u68c0\u7b49\u573a\u666f\u3002<\/p>","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[23],"tags":[13,108,109],"class_list":["post-396","post","type-post","status-publish","format-standard","hentry","category-freeswitch","tag-freeswitch","tag-108","tag-109"],"views":121,"_links":{"self":[{"href":"https:\/\/www.liaoxinghui.com\/index.php?rest_route=\/wp\/v2\/posts\/396","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.liaoxinghui.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.liaoxinghui.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.liaoxinghui.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.liaoxinghui.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=396"}],"version-history":[{"count":2,"href":"https:\/\/www.liaoxinghui.com\/index.php?rest_route=\/wp\/v2\/posts\/396\/revisions"}],"predecessor-version":[{"id":408,"href":"https:\/\/www.liaoxinghui.com\/index.php?rest_route=\/wp\/v2\/posts\/396\/revisions\/408"}],"wp:attachment":[{"href":"https:\/\/www.liaoxinghui.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=396"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.liaoxinghui.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=396"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.liaoxinghui.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=396"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}