Added information about the underlaying system API. Added frame capture tests for DirectShow and MediaFoundation in the builds.

Author: hipersayanX

Manager/src/cmdparser.cpp

@@ -119,6 +119,7 @@ namespace AkVCam {
             int defaultHandler(const StringMap &flags,
                                const StringVector &args);
             int showHelp(const StringMap &flags, const StringVector &args);
+            int showSystemAPI(const StringMap &flags, const StringVector &args);
             int showDevices(const StringMap &flags, const StringVector &args);
             int addDevice(const StringMap &flags, const StringVector &args);
             int removeDevice(const StringMap &flags, const StringVector &args);
@@ -205,6 +206,10 @@ AkVCam::CmdParser::CmdParser()
     this->addFlags("",
                    {"--build-info"},
                    "Show build information.");
+    this->addCommand("system-api",
+                     "",
+                     "Show the virtual camera API being used.",
+                     AKVCAM_BIND_FUNC(CmdParserPrivate::showSystemAPI));
     this->addCommand("devices",
                      "",
                      "List devices.",
@@ -891,6 +896,17 @@ int AkVCam::CmdParserPrivate::showHelp(const StringMap &flags,
     return 0;
 }
 
+int AkVCam::CmdParserPrivate::showSystemAPI(const StringMap &flags,
+                                            const StringVector &args)
+{
+    UNUSED(flags);
+    UNUSED(args);
+
+    auto api = this->m_ipcBridge.systemAPI();
+
+    AkPrintOut(api.c_str());
+}
+
 int AkVCam::CmdParserPrivate::showDevices(const StringMap &flags,
                                           const StringVector &args)
 {

VCamUtils/src/ipcbridge.h

@@ -86,6 +86,7 @@ namespace AkVCam
 
             /* Server & Client */
 
+            std::string systemAPI() const;
             std::string picture() const;
             void setPicture(const std::string &picture);
             int logLevel() const;

capi/src/capi.cpp

@@ -149,6 +149,26 @@ CAPI_EXPORT void vcam_close(void *vcam)
         delete reinterpret_cast<VCamAPI *>(vcam);
 }
 
+CAPI_EXPORT void vcam_system_api(void *vcam,
+                                 char *api_name,
+                                 size_t *api_name_len)
+{
+    // Validate buffer_size
+    if (!api_name_len)
+        return -EINVAL;
+
+    // Cast vcam to VCamAPI
+    auto vcamApi = reinterpret_cast<VCamAPI *>(vcam);
+
+    auto apiName = vcamApi->m_bridge.systemAPI();
+    *api_name_len = apiName.size() + 1;
+
+    if (api_name)
+        snprintf(api_name, *api_name_len, "%s", apiName.c_str());
+
+    return apiName.size();
+}
+
 CAPI_EXPORT int vcam_devices(void *vcam, char *devs, size_t *buffer_size)
 {
     // Validate buffer_size

capi/src/capi.h

@@ -45,6 +45,11 @@ CAPI_EXPORT void *vcam_open();
 // Close the virtual camera
 CAPI_EXPORT void vcam_close(void *vcam);
 
+// Show the virtual camera API being used
+CAPI_EXPORT void vcam_system_api(void *vcam,
+                                 char *api_name,
+                                 size_t *api_name_len);
+
 // List devices.
 CAPI_EXPORT int vcam_devices(void *vcam, char *devs, size_t *buffer_size);
 

cmio/PlatformUtils/src/utils.cpp

@@ -25,6 +25,7 @@
 #include <CoreGraphics/CGImage.h>
 #include <CoreGraphics/CGDataProvider.h>
 #include <libproc.h>
+#include <sys/sysctl.h>
 
 #include "utils.h"
 #include "preferences.h"
@@ -132,6 +133,29 @@ std::string AkVCam::locatePluginPath()
     return fileExists(file)? file: std::string();
 }
 
+bool AkVCam::supportsCmioExtensionVCam()
+{
+    char version[16];
+    size_t size = sizeof(version);
+
+    // Get the commercial version of macOS
+    if (sysctlbyname("kern.osproductversion", version, &size, NULL, 0) != 0)
+        return false;
+
+    // Get the major and minor number (major.minor)
+    int major = 0, minor = 0;
+    sscanf(version, "%d.%d", &major, &minor);
+
+    // CMIO Extensions requires macOS 12.3 or higher
+    if (major > 12)
+        return true;
+
+    if (major == 12 && minor >= 3)
+        return true;
+
+    return false;
+}
+
 std::string AkVCam::tempPath()
 {
     return {"/tmp"};

cmio/PlatformUtils/src/utils.h

@@ -35,6 +35,7 @@ namespace AkVCam
     std::string locateManagerPath();
     std::string locateServicePath();
     std::string locatePluginPath();
+    bool supportsCmioExtensionVCam();
     std::string tempPath();
     bool uuidEqual(const REFIID &uuid1, const CFUUIDRef uuid2);
     std::string enumToString(uint32_t value);

cmio/VCamIPC/src/ipcbridge.cpp

@@ -209,6 +209,13 @@ AkVCam::IpcBridge::~IpcBridge()
     delete this->d;
 }
 
+std::string AkVCam::IpcBridge::systemAPI() const
+{
+    return supportsCmioExtensionVCam()?
+                "CoreMediaIO Extension":
+                "CoreMediaIO";
+}
+
 std::string AkVCam::IpcBridge::picture() const
 {
     return this->d->m_picture;