FFmpegKit 跨平台抽象层

FFmpegKit 中的跨平台抽象层代表了一种复杂的架构模式，它在保持平台特定优化的同时，实现了跨多个平台的一致 FFmpeg 功能。该抽象层作为统一 API 的基础，无论目标平台如何，开发者都可以使用这些 API。

1、核心架构理念

FFmpegKit 的抽象层遵循基于协议的设计，其中每个平台都实现核心抽象定义的通用接口。该架构围绕三个基本抽象构建：

会话协议 (Session Protocol)：定义所有执行会话的契约。
抽象会话实现 (Abstract Session Implementation)：提供跨平台的共享功能。
平台特定适配器 (Platform Specific Adapters)：处理平台特定的细节。

会话协议作为基石，确保无论你在 Android (Java)、Apple (Objective-C)、Linux (C++) 还是通过框架 (Dart/JavaScript) 使用，核心行为都保持一致。

2、会话接口抽象 (Session Interface)

Session 协议定义了所有平台实现都必须遵循的通用契约。这种并行结构确保了 API 一致性，同时允许每个平台利用其原生优势和约定。

2.1、Apple (Objective-C) 实现

来源: apple/src/Session.h

@protocol Session
@required
- (LogCallback)getLogCallback;
- (long)getSessionId;
- (SessionState)getState;
- (ReturnCode*)getReturnCode;
// ... 其他必需方法
@end

2.2、Linux (C++) 实现

来源: linux/src/Session.h

class Session {
    public:
        virtual ffmpegkit::LogCallback getLogCallback() const = 0;
        virtual long getSessionId() const = 0;
        virtual ffmpegkit::SessionState getState() const = 0;
        virtual std::shared_ptr<ffmpegkit::ReturnCode> getReturnCode() const = 0;
        // ... 其他虚方法
};

3、抽象会话基类 (AbstractSession)

AbstractSession 类提供共享实现，减少了跨平台的代码重复。它实现了共享业务逻辑，同时保持了平台特定的内存管理和线程模型。

3.1、Apple 平台实现

来源: apple/src/AbstractSession.h特点：利用 Objective-C 的引用计数。

@interface AbstractSession : NSObject<Session>
- (instancetype)init:(NSArray*)arguments 
         withLogCallback:(LogCallback)logCallback 
withLogRedirectionStrategy:(LogRedirectionStrategy)logRedirectionStrategy;
- (void)waitForAsynchronousMessagesInTransmit:(int)timeout;
@end

3.2、Linux 平台实现

来源: linux/src/AbstractSession.h

特点：利用 C++ 智能指针。

class AbstractSession : public Session, std::enable_shared_from_this<AbstractSession> {
    public:
        static constexpr int DefaultTimeoutForAsynchronousMessagesInTransmit = 5000;
        AbstractSession(const std::list<std::string>& arguments, 
                       const ffmpegkit::LogCallback logCallback, 
                       const LogRedirectionStrategy logRedirectionStrategy);
        void waitForAsynchronousMessagesInTransmit(const int timeout) const;
};