video-pc/AvRecorder/basic/basic.h

#ifndef __BASIC_FUCN_H__
#define __BASIC_FUCN_H__
#define __STDC_FORMAT_MACROS

#include <functional>
#include <mutex>
#include <thread>

extern "C" {
#include <libavcodec/avcodec.h>
#include <libavformat/avformat.h>
}

// ***************
// MUTEX
extern std::mutex __mtx;

// ***************
// debug function

#define __AVDEBUG

#ifdef __AVDEBUG
#define __DebugPrint(fmtStr, ...) \
    std::printf("[" __FILE__ ", line:%d] " fmtStr "\n", __LINE__, ##__VA_ARGS__)
#define __Str(exp) #exp
#define __Check(retVal, ...)                            \
    do {                                                \
        if (!(__VA_ARGS__)) {                           \
            __DebugPrint(__Str(__VA_ARGS__) " failed"); \
            return retVal;                              \
        }                                               \
    } while (false)

#else
#define __DebugPrint(fmtStr, ...)
#define __Check(retVal, ...)  \
    do {                      \
        if (!(__VA_ARGS__)) { \
            return retVal;    \
        }                     \
    } while (false)
#endif

#define __CheckNo(...) __Check(, __VA_ARGS__)
#define __CheckBool(...) __Check(false, __VA_ARGS__)
#define __CheckNullptr(...) __Check(nullptr, __VA_ARGS__)
enum class MediaType {
    AUDIO,
    VIDEO
};

// ***************
// memory function

template <typename T, typename Func>
void Free(T*& ptr, Func&& func)
{
    static_assert(std::is_convertible_v<Func, std::function<void()>>, "Type Func should be std::function<void()>");
    if (ptr == nullptr) {
        return;
    }

    func();
    ptr = nullptr;
}

//***************
// time function

// Sleep x ms
inline void SleepMs(int timeMs)
{
    std::this_thread::sleep_for(std::chrono::milliseconds(timeMs));
}

// =================== 音频全局设置 ===================
// 此处配置影响全局的音频捕获和编码参数，旨在平衡音质与文件大小。

// --- 采样率 (Sample Rate) ---
// 48000 Hz: 专业音频和视频的标准，提供高质量的音频。
// 44100 Hz: CD音质标准，兼容性好。
// 16000 Hz: 通讯领域常用，适用于纯语音，体积小。
// 推荐使用 48000 或 44100。
constexpr int AUDIO_SAMPLE_RATE = 48000;

// --- 声道数 (Channels) ---
// 1 (Mono): 单声道。体积小，适用于语音、旁白等场景。兼容性最佳。
// 2 (Stereo): 立体声。提供空间感，适用于音乐、游戏等场景。体积是单声道的两倍。
// 为了平衡音质和文件大小，推荐使用单声道。
constexpr int AUDIO_CHANNEL = 1;

// --- 采样格式 (Sample Format) ---
// FFmpeg编码器期望的输入格式。捕获的PCM数据会被重采样成此格式。
// AV_SAMPLE_FMT_FLTP: 浮点型，平面存储。可以提供更大的动态范围。
constexpr AVSampleFormat AUDIO_FMT = AV_SAMPLE_FMT_FLTP;

// --- 捕获采样位深 (Capture Bit Depth) ---
// 从系统音频设备请求的原始PCM数据的位深度。
// 16-bit (Signed Integer): 兼容性极好，是大多数音频设备和API的标准格式。
// 编码时，此格式数据会被转换为上面定义的 AUDIO_FMT (如32-bit float)。
constexpr int AUDIO_CAPTURE_BITS_PER_SAMPLE = 16;

// --- 设备索引 ---
constexpr int MICROPHONE_INDEX = 0;
constexpr int SPEAKER_INDEX = 1;

#endif