OBS源码使用学习（一）之摄像头采集相关

我之前也没接触过obs相关的东西，磕磕绊绊可好一阵。现在特把obs的研究心得记录下来，也希望学习这个的萌新们能够少走弯路。

一.从OBS的使用中知晓大体流程

直接看代码，对于刚刚接触obs的萌新而言非常困难，会让人摸不着头脑。

我们可以直接使用OBS，从所需要的步骤中知晓大体流程，找出关键步骤，进而有目的有针对性地阅读代码，并可以更顺利地找出核心代码。

首先，我们先创建一个源：

我们可以看出，这一步 我们只创建了源的名称。

接下来，我们点击确认进入下一步：

这一步，包括了设置以及设备选择。

因此，我们从明确了 obs摄像头采集的关键点和步骤：

1.创建视频采集源及其名称

2.获取设备列表

3.将设备以及其他参数一并进行设置

我们在明确了这三个步骤后，就可以以这三个步骤为框架，进行代码的阅读与编写。

二. 创建视频采集源及其名称

obs采集，录制等等的核心，都是依靠obs的源（以下称为source）。

而obs在源的获取方面，也是相当的方便，obs已经在插件中创建了各种结构体供大家使用，也有对应的函数可以直接完成source的操作。

使用函数

obs_source_t *obs_source_create(const char *id, const char *name,
				       obs_data_t *settings,
				       obs_data_t *hotkey_data);

即可完成对应操作，具体实例如下：

obs_source_t* captureSource;
captureSource = obs_source_create("dshow_input", "DshowWindowsCapture",NULL, nullptr);

其中，dshow_input就是插件预留的结构体名称，我们直接使用这个名称（windows下使用的是dshow，而在linux中则是v4l2）。

当然，如果你想获得比如桌面操作，声音等等，我们可以使用其他的名称，比如monitor_capture，wasapi_input_capture等等。

总而言之，你输入什么名称，obs_source_create就可以获得对应source，大家可以从源码中查看都有哪些可供我们使用。

后面的DshowWindowsCapture则是这个source的名字，我们之后可以通过这个名字来获取到对应的source。

二.获取设备列表

想要打开摄像头设备，就要知道摄像头设备的ID。

既然我们是打算打开摄像头，就要看一下win-dshow对应的代码了。

在win-dshow.cpp的代码中，我们一眼就能看到：

从宏定义中的就可以看出VIDEO_DEVICE_ID对应的字符串就是"video_device_id"，我们从直接找这个关键字，然后通过这个关键字找出对应的设备ID就行。

先创建一个储存设备ID的容器：

vector<string> CameraID;

之后我们创建一个函数，将获得的所有设备ID都装进去：

void get_camera_id(obs_source_t* obst)
{
    obs_properties_t* ppts = obs_source_properties(obst);
    obs_property_t* property = obs_properties_first(ppts);
    while (property)
    {
        const char* name = obs_property_name(property);
        if (strcmp(name, "video_device_id") == 0)
        {
            size_t  count = obs_property_list_item_count(property);
            for (size_t i = 0; i < count; i++)
            {
                const char* str = obs_property_list_item_string(property, i);
                CameraID.push_back(str);
            }
        }

        obs_property_next(&property);
    }

}

这样，我们就将所有的设备ID全都放入了CameraID中。

三.将设备以及其他参数一并进行设置

最后，我们继续回到包含着obs_source_create的函数中，将video_device_id设置进去：

const char* deviceID = "";
if(!CameraID.empty())
{
    deviceID = CameraID[0].c_str();
    //这里我选择了0号设备，大家也可以使用UI制作设备列表进行选择等其他方式使用
}


obs_data_t* setting = obs_data_create();
obs_data_t* curSetting = obs_source_get_settings(captureSource);
//把当前默认的设置都拿出来

obs_data_apply(setting, curSetting);
obs_data_set_string( setting, "id", "dshow_input" );
obs_data_set_string( setting, "video_device_id",  deviceID );
obs_source_update( captureSource, setting );
//把设备id放进去，然后更新设置

properties = obs_source_properties(captureSource);
obs_property_t *property = obs_properties_first(properties);
while (property) {
    obs_property_next(&property);
}

obs_data_release(setting);
//把内存中分配的obs_data空间释放掉

至此大功告成，接下来就是在使用摄像头采集的时候所用到的一些问题了。 

四.常见问题

1.切换源

我们想切换源的时候，将不同的源设置到对应的输出通道中就可以了。

通过这个函数：

void obs_set_output_source(uint32_t channel, obs_source_t *source)

至于如何获得source，我们可以通过创建不同的source，将source指针指向不同的source获得，

而得到不同source的方法是使用这个函数：

obs_source_t *obs_get_source_by_name(const char *name)

我们只需要将我们obs_source_create时候的名字输入进入，然后用一个指向obs_source_t的指针指向他就可以了，例如：

obs_source_t * dsource = obs_get_source_by_name("DshowWindowsCapture");

2.摄像头设备被占用

有时候我们创建了这个摄像头的source，但是现在想关掉这个source。

或者是开启新采集程序，发现摄像头被占用了。

这种情况，我们就需要将摄像头设备deactivate

我们通过上述的代码找到对应的source，然后把obs源码中对应的active操作中代码拷贝过来即可：

obs_source_t * dsource = obs_get_source_by_name("DshowWindowsCapture");
bool active;
OBSWeakSource this_weakSource;
this_weakSource = OBSGetWeakRef(dsource);
OBSSource source = OBSGetStrongRef(this_weakSource);
obs_data_t *settings = obs_source_get_settings(source);
bool now_active = obs_data_get_bool(settings, "active");
obs_data_release(settings);

active = false;//active就是TRUE，deactivate就是FALSE

calldata_t cd = {};
calldata_set_bool(&cd, "active", active);
proc_handler_t *ph = obs_source_get_proc_handler(source);
proc_handler_call(ph, "activate", &cd);
calldata_free(&cd);

我们可以根据active的TRUE和FALSE来决定是active还是deactivate