近期有較多用戶咨詢通話錄音功能的實(shí)現(xiàn)方案及相關(guān)參考案例。

AirUI 可視化方案目前仍在優(yōu)化中，具備輕量化、低成本、高可靠性等特性，在工業(yè)場(chǎng)景具備一定應(yīng)用價(jià)值。

針對(duì)用戶對(duì)通話錄音功能的需求，本文提供一套可直接落地的實(shí)現(xiàn)方案，支持自動(dòng)接聽與自動(dòng)錄音，適用于暫不使用可視化 UI 的開發(fā)場(chǎng)景參考。

一、方案功能

基于LuatOS開發(fā)，適配多種型號(hào)核心板，可實(shí)現(xiàn)低成本通話留痕，適用于客服系統(tǒng)、會(huì)議記錄、遠(yuǎn)程問診、話務(wù)工單追溯等場(chǎng)景。
主要功能特色如下：

自動(dòng)接聽： 來電響鈴2聲后自動(dòng)接聽，無需手動(dòng)操作。

自動(dòng)錄音： 通話接通后自動(dòng)開始錄音，對(duì)方掛斷后自動(dòng)停止。

SD卡存儲(chǔ)： 錄音文件以PCM格式保存到SD卡，支持自動(dòng)掛載和空間檢測(cè)。

數(shù)據(jù)優(yōu)化： 只保存上行數(shù)據(jù)，避免下行數(shù)據(jù)造成的回聲問題。

跨模組兼容： Air780EHM、Air780EGH、Air780EHV、Air8000系列核心板，均可通過外掛音頻配件板和SD卡存儲(chǔ)配件板實(shí)現(xiàn)。

簡(jiǎn)而言之：一套方案搞定多個(gè)硬件型號(hào)，極大提升開發(fā)效率。

二、主要硬件準(zhǔn)備

方案一：Air8000/Air780EHV開發(fā)板

開發(fā)板提供了豐富的音頻接口資源，可通過開發(fā)板上的音頻接口進(jìn)行連接和測(cè)試。

如Air8000/Air780EHV開發(fā)板：

方案二：核心板+配件板

如果沒有Air780EHV和Air8000系列Turnkey開發(fā)板，那么可使用Air780EHM、Air780EGH、Air780EHV、Air8000系列核心板，通過外掛音頻配件板和存儲(chǔ)配件板來實(shí)現(xiàn)通話錄音功能。

AirAUDIO_1010音頻配件板： 負(fù)責(zé)音頻輸入輸出；

AirMICROSD_1010存儲(chǔ)配件板： 提供SD卡存儲(chǔ)功能。

連接小貼士： 如果搭配AirAUDIO_1010擴(kuò)展板測(cè)試，需將擴(kuò)展板中PA開關(guān)撥到OFF，讓軟件控制PA，避免pop音。

本文以Air780EGH為例：

接線方式參照下方圖表對(duì)應(yīng)連接（注意不同型號(hào)核心板具體引腳號(hào)差異）：

三、開源示例與教程
基于LuatOS開發(fā)的通話錄音示例已上傳Gitee開源倉庫，即便是新接觸LuatOS開發(fā)的朋友，也可以根據(jù)合宙資料中心提供配套實(shí)操教程快速上手。

核心功能模塊包括SD卡掛載、通話狀態(tài)機(jī)、錄音數(shù)據(jù)回調(diào)等，完整示例代碼詳見源碼倉庫最新文件。

--[[

錄音功能特性：
- 錄音文件保存為PCM格式：/sd/record_call.pcm
- 只保存上行數(shù)據(jù)（包含本地聲音和網(wǎng)絡(luò)回聲）
- 下行數(shù)據(jù)自動(dòng)跳過，避免重復(fù)存儲(chǔ)
- 支持SD卡自動(dòng)掛載和空間檢測(cè)
   
-- ====================== 錄音功能 ======================

-- 創(chuàng)建音頻數(shù)據(jù)緩沖區(qū)
local up1 = zbuff.create(BUFFER_SIZE,0)      -- 上行數(shù)據(jù)保存區(qū)1
local up2 = zbuff.create(BUFFER_SIZE,0)      -- 上行數(shù)據(jù)保存區(qū)2
local down1 = zbuff.create(BUFFER_SIZE,0)    -- 下行數(shù)據(jù)保存區(qū)1
local down2 = zbuff.create(BUFFER_SIZE,0)    -- 下行數(shù)據(jù)保存區(qū)2

-- 打開錄音文件
local function open_record_file()
    -- 先掛載SD卡
    if not mount_sd_card() then
        log.error("錄音文件", "SD卡掛載失敗，無法進(jìn)行錄音")
        return false
    end

    log.info("錄音文件", "SD卡掛載成功，錄音文件將保存到SD卡")

    -- 關(guān)閉已打開的文件
    if record_file then
        record_file:close()
        record_file = nil
    end

    -- 刪除舊錄音文件
    if io.exists(RECORD_FILE_PATH) then
        os.remove(RECORD_FILE_PATH)
        log.info("錄音文件", "刪除舊錄音文件:", RECORD_FILE_PATH)
    end

    -- 創(chuàng)建錄音文件
    record_file = io.open(RECORD_FILE_PATH, "wb")

    if record_file then
        log.info("錄音文件", "創(chuàng)建錄音文件成功:", RECORD_FILE_PATH)
        record_start_time = mcu.ticks()
        is_recording_to_file = true
        return true
    else
        log.error("錄音文件", "創(chuàng)建錄音文件失敗:", RECORD_FILE_PATH)
        return false
    end
end

-- 關(guān)閉錄音文件
local function close_record_file()
    if record_file then
        record_file:close()
        record_file = nil

        local file_size = io.fileSize(RECORD_FILE_PATH)
        record_duration = (mcu.ticks() - record_start_time) / 1000  -- 轉(zhuǎn)換為秒

        log.info("錄音文件", "錄音完成", "文件大小:", file_size, "字節(jié)", "錄音時(shí)長(zhǎng):", string.format("%.1f", record_duration), "秒", "路徑:", RECORD_FILE_PATH)

        is_recording_to_file = false
        record_start_time = 0
        record_duration = 0
    end
end

-- 寫入錄音數(shù)據(jù)到文件
local function write_record_data(buff, is_downlink)
    if not record_file or not is_recording_to_file then
        return false
    end

    -- 保存數(shù)據(jù)
    if not is_downlink then
        local data_size = buff:used()
        if data_size > 0 then
            local start_time = mcu.ticks()

            -- 寫入數(shù)據(jù)到文件
            record_file:write(buff:query())

            local end_time = mcu.ticks()
            local write_time = end_time - start_time
            local write_speed = data_size / (write_time / 1000)  -- 字節(jié)/秒

            log.info("錄音寫入", 
                    "數(shù)據(jù)大小:", data_size, "字節(jié),", 
                    "寫入耗時(shí):", string.format("%.2f", write_time), "ms,",
                    "寫入速度:", string.format("%.2f", write_speed / 1024), "KB/s")

            return true
        end
    else
        -- 下行數(shù)據(jù)不保存，只記錄日志
        -- 寫入下行數(shù)據(jù)會(huì)導(dǎo)致文件內(nèi)有回聲
        local data_size = buff:used()
        if data_size > 0 then
            log.info("錄音寫入", "下行數(shù)據(jù)跳過", "數(shù)據(jù)大小:", data_size, "字節(jié)")
        end
    end
    return false
end

-- 音頻數(shù)據(jù)回調(diào)函數(shù)
local function recordCallback(is_dl, point)
    if is_dl then
        log.info("錄音", "下行數(shù)據(jù)，位于緩存", point+1, "緩存1數(shù)據(jù)量", down1:used(), "緩存2數(shù)據(jù)量", down2:used())

        -- 處理下行數(shù)據(jù)
        if point == 0 then
            write_record_data(down1, true)
            down1:del()  -- 清空緩沖區(qū)
        else
            write_record_data(down2, true)
            down2:del()  -- 清空緩沖區(qū)
        end
    else
        log.info("錄音", "上行數(shù)據(jù)，位于緩存", point+1, "緩存1數(shù)據(jù)量", up1:used(), "緩存2數(shù)據(jù)量", up2:used())

        -- 處理上行數(shù)據(jù)
        if point == 0 then
            write_record_data(up1, false)
            up1:del()  -- 清空緩沖區(qū)
        else
            write_record_data(up2, false)
            up2:del()  -- 清空緩沖區(qū)
        end
    end
    log.info("通話質(zhì)量", cc.quality())
end

-- 啟用通話錄音
local function enableRecording()
    cc.record(true, up1, up2, down1, down2)
    cc.on("record", recordCallback)
    log.info("cc_app", "通話錄音已啟用")
end

-- 開始通話錄音到文件
local function start_call_recording()
    if open_record_file() then
        log.info("通話錄音", "開始錄音到文件:", RECORD_FILE_PATH)
        return true
    else
        log.error("通話錄音", "無法開始錄音到文件，請(qǐng)檢查SD卡")
        return false
    end
end

-- 停止通話錄音到文件
local function stop_call_recording()
    close_record_file()
    log.info("通話錄音", "停止錄音到文件")
end

-- 獲取所有緩沖區(qū)
local function getRecordingBuffers()
    return {
        up1 = up1,
        up2 = up2,
        down1 = down1,
        down2 = down2
    }
end

-- 獲取錄音文件信息
local function get_record_file_info()
    if io.exists(RECORD_FILE_PATH) then
        local file_size = io.fileSize(RECORD_FILE_PATH)
        return {
            path = RECORD_FILE_PATH,
            size = file_size,
            duration = record_duration,
            exists = true
        }
    else
        return {
            path = RECORD_FILE_PATH,
            size = 0,
            duration = 0,
            exists = false
        }
    end
end

-- 呼入自動(dòng)接聽，等待對(duì)方掛斷
local function handle_scenario(status)
    if status == "INCOMINGCALL" then
        -- 獲取來電號(hào)碼
        caller_number = cc.lastNum() or "未知號(hào)碼"
        call_counter = call_counter + 1

        log.info("收到來電，號(hào)碼:", caller_number, "響鈴次數(shù):", call_counter)

        -- 響鈴2聲后自動(dòng)接聽
        if call_counter >= 2 then
            log.info("自動(dòng)接聽來電")
            cc.accept(0)
            call_counter = 0  -- 重置計(jì)數(shù)器
        end
    elseif status == "SPEECH_START" then
        -- 語音通話真正開始
        log.info("電話已接通，電話號(hào)碼:", caller_number)

        -- 開始通話錄音到文件
        start_call_recording()
    elseif status == "DISCONNECTED" then
        -- 對(duì)方掛斷通話
        log.info("通話結(jié)束對(duì)方掛斷")

        -- 停止通話錄音到文件
        stop_call_recording()

        call_counter = 0  -- 重置計(jì)數(shù)器
    end
end

-- ====================== 主事件處理器 ======================
sys.subscribe("CC_IND", function(status)
    log.info("CC狀態(tài)", status)
    handle_scenario(status)

    -- 需要處理的通用狀態(tài)
    if status == "READY" then
        sys.publish("CC_READY")  -- 發(fā)布系統(tǒng)就緒事件
    elseif status == "HANGUP_CALL_DONE" or status == "MAKE_CALL_FAILED" or status == "DISCONNECTED" then
        exaudio.pm(audio.SHUTDOWN)   --主動(dòng)進(jìn)入低功耗模式
    end
end)

-- ====================== 電話系統(tǒng)初始化 ======================
local function init_cc()
    -- 先嘗試掛載SD卡
    mount_sd_card()

    -- 初始化音頻設(shè)備
    audio_drv.initAudioDevice()

    -- 等待電話系統(tǒng)就緒
    sys.waitUntil("CC_READY")

    -- 初始化電話功能
    cc.init(audio_drv.getMultimediaId())

    -- 啟用通話錄音（錄音功能在cc_app中）
    enableRecording()

    log.info("cc_app", "電話系統(tǒng)初始化完成")
end

-- 啟動(dòng)初始化任務(wù)
sys.taskInit(init_cc)

四、使用注意事項(xiàng)

必須插入SD卡才能使用錄音功能，因?yàn)殇浺粑募^大無法存入內(nèi)存；緩沖區(qū)大小必須是640的倍數(shù)，否則可能導(dǎo)致錄音異常。

錄音文件保存在SD卡的/sd/record_call.pcm路徑下，可以通過讀卡器在電腦上查看；錄音文件為原始PCM格式，需要使用專用播放器（如Audacity ）播放。

審核編輯 黃宇