現(xiàn)自定義視頻編碼器？)
OBS Studio 如何用 obs_encoder_info 實(shí)現(xiàn)自定義視頻編碼器【免費(fèi)下載鏈接】obs-studioOBS Studio - Free and open source software for live streaming and screen recording項(xiàng)目地址: https://gitcode.com/GitHub_Trending/ob/obs-studio如果你需要讓 OBS Studio 的推流/錄像輸出支持一個(gè)新的視頻編碼實(shí)現(xiàn)而不是替換整個(gè)輸出模塊正確的做法是編寫一個(gè)插件模塊用obs_encoder_info結(jié)構(gòu)體描述你的編碼器并在模塊加載時(shí)注冊(cè)到 libobs。本文基于倉(cāng)庫(kù)內(nèi)的 插件開發(fā)文檔、編碼器 API 參考 以及內(nèi)置的 obs-x264 編碼器插件 源碼給出從定義編碼器結(jié)構(gòu)到注冊(cè)、構(gòu)建、驗(yàn)證的完整路徑。適用前提你能編譯 C/C 代碼并構(gòu)建 OBS 插件模塊插件機(jī)制文檔位于 docs/sphinx/plugins.rst編碼器專用頭文件是 libobs/obs-encoder.h。官方文檔說明編碼器的定位是OBS 專用的音視頻編碼器實(shí)現(xiàn)配合使用編碼器的輸出工作通常面向 h264/aac 這類流媒體與錄像場(chǎng)景。插件模塊的目錄結(jié)構(gòu)與 CMake 構(gòu)建插件模塊可以實(shí)現(xiàn)的 libobs 對(duì)象包括 sources、outputs、encoders 和 services。文檔給出的常規(guī)組織方式是一個(gè)文件負(fù)責(zé)插件初始化另外的文件分別定義各對(duì)象。對(duì)只包含一個(gè)編碼器的最小插件目錄可以是my-encoder-plugin/data/locale/en-US.ini my-encoder-plugin/CMakeLists.txt my-encoder-plugin/my-plugin.c my-encoder-plugin/my-encoder.c對(duì)應(yīng)的 CMakeLists.txt文檔示例見 plugins.rst# my-plugin/CMakeLists.txt project(my-plugin) set(my-plugin_SOURCES my-plugin.c my-encoder.c) add_library(my-plugin MODULE ${my-plugin_SOURCES}) target_link_libraries(my-plugin libobs) install_obs_plugin_with_data(my-plugin data)如果編碼器依賴第三方編解碼庫(kù)可以參考內(nèi)置 x264 插件的真實(shí) CMakeLists.txtcmake_minimum_required(VERSION 3.28...3.30) find_package(Libx264 REQUIRED) if(NOT TARGET OBS::opts-parser) add_subdirectory(${CMAKE_SOURCE_DIR}/shared/opts-parser ${CMAKE_BINARY_DIR}/shared/opts-parser) endif() add_library(obs-x264 MODULE) add_library(OBS::x264 ALIAS obs-x264) target_sources(obs-x264 PRIVATE obs-x264.c obs-x264-plugin-main.c) target_link_libraries(obs-x264 PRIVATE OBS::opts-parser Libx264::Libx264)它展示了三個(gè)要點(diǎn)用find_package定位外部依賴Libx264 REQUIRED、用add_library(... MODULE)產(chǎn)出動(dòng)態(tài)庫(kù)、用target_link_libraries鏈接依賴。填寫 obs_encoder_info 結(jié)構(gòu)體編碼器定義集中在 libobs/obs-encoder.h 的struct obs_encoder_info。按頭文件注釋字段分為Required implementation必選和Optional implementation可選兩部分必選字段字段說明id編碼器唯一字符串標(biāo)識(shí)文檔明確標(biāo)注 requiredtype編碼器類型視頻編碼器填OBS_ENCODER_VIDEO音頻填OBS_ENCODER_AUDIOcodec編解碼器字符串如 h264get_name返回編碼器的可翻譯名稱create用 settings 創(chuàng)建實(shí)現(xiàn)數(shù)據(jù)初始化失敗返回 NULLdestroy銷毀實(shí)現(xiàn)數(shù)據(jù)encode編碼音視頻幀輸出encoder_packetget_frame_size僅音頻編碼器使用返回每幀的采樣數(shù)如 AAC 為 1024可選字段視頻編碼器常用的get_defaults在 settings 上調(diào)用obs_data_set_default*系列函數(shù)設(shè)置默認(rèn)值、get_properties生成屬性列表前端可據(jù)此自動(dòng)生成設(shè)置界面、update更新設(shè)置通常用于運(yùn)行中改變碼率、get_extra_data通常返回編碼器頭數(shù)據(jù)、get_sei_data返回 SEI 數(shù)據(jù)、get_video_info告知后端輸入視頻需要轉(zhuǎn)換的格式或尺寸、caps能力標(biāo)志按位或組合。caps的取值直接來自 obs-encoder.h#define OBS_ENCODER_CAP_DEPRECATED (1 0) #define OBS_ENCODER_CAP_PASS_TEXTURE (1 1) #define OBS_ENCODER_CAP_DYN_BITRATE (1 2) #define OBS_ENCODER_CAP_INTERNAL (1 3) #define OBS_ENCODER_CAP_ROI (1 4) #define OBS_ENCODER_CAP_SCALING (1 5) #define OBS_ENCODER_CAP_MULTITRACK_DYN_BITRATE (1 6)文檔給出的最小示例編碼器示例代碼來自 plugins.rst/* my-encoder.c */ struct obs_encoder_info my_encoder { .id my_encoder, .type OBS_ENCODER_VIDEO, .codec h264, .get_name my_encoder_name, .create my_encoder_create, .destroy my_encoder_destroy, .encode my_encoder_encode, .update my_encoder_update, .get_extra_data my_encoder_extra_data, .get_sei_data my_encoder_sei_data, .get_video_info my_encoder_video_info };對(duì)照內(nèi)置 x264 編碼器的真實(shí)注冊(cè)結(jié)構(gòu)obs-x264.c可以看到完整字段組合struct obs_encoder_info obs_x264_encoder { .id obs_x264, .type OBS_ENCODER_VIDEO, .codec h264, .get_name obs_x264_getname, .create obs_x264_create, .destroy obs_x264_destroy, .encode obs_x264_encode, .update obs_x264_update, .get_properties obs_x264_props, .get_defaults obs_x264_defaults, .get_extra_data obs_x264_extra_data, .get_sei_data obs_x264_sei, .get_video_info obs_x264_video_info, .caps OBS_ENCODER_CAP_DYN_BITRATE | OBS_ENCODER_CAP_ROI, };兩個(gè)實(shí)現(xiàn)細(xì)節(jié)值得注意get_properties的data參數(shù)可能為 NULL——當(dāng)對(duì)編碼器類型而不是某個(gè)實(shí)例調(diào)用obs_get_encoder_properties()時(shí)會(huì)發(fā)生文檔要求實(shí)現(xiàn)方妥善處理這一情況。encode的返回值語義true表示成功false表示 critical failure嚴(yán)重失敗。encode 回調(diào)與 encoder_packetencode的原型是bool (*encode)(void *data, struct encoder_frame *frame, struct encoder_packet *packet, bool *received_packet)。輸入幀結(jié)構(gòu) encoder_frame 包含原始數(shù)據(jù)平面data[MAX_AV_PLANES]、每個(gè)平面的行步長(zhǎng)linesize、音頻幀數(shù)frames僅音頻和呈現(xiàn)時(shí)間戳pts。輸出要填寫 encoder_packet其中由編碼器實(shí)現(xiàn)方負(fù)責(zé)設(shè)置的字段是data、size、pts、dts、timebase_num、timebase_den、type填OBS_ENCODER_VIDEO和keyframe。文檔明確標(biāo)注以下字段should not be set by the encoder implementation由 libobs 內(nèi)部填充dts_usec、sys_dts_usec、priority已不再使用、drop_priority、track_idx、encoder。*received_packet需要你在每次調(diào)用中顯式設(shè)置本次調(diào)用是否產(chǎn)出了一個(gè) packet。內(nèi)置 x264 編碼器的處理方式obs-x264.c*received_packet (nal_count ! 0); parse_packet(obsx264, packet, nals, nal_count, pic_out); return true;即按實(shí)際產(chǎn)出的 NAL 數(shù)量決定是否置位received_packet隨后填充 packet 并返回true。另外如果編碼器運(yùn)行中會(huì)輸出頭數(shù)據(jù)如 SPS/PPS實(shí)現(xiàn)get_extra_data返回true并填好extra_data與size沒有頭數(shù)據(jù)時(shí)返回false。x264 的實(shí)現(xiàn)obs-x264.c就是在上下文存在時(shí)返回緩存的extra_data否則返回false。在 obs_module_load 中注冊(cè)編碼器插件初始化文件的職責(zé)是聲明模塊并在obs_module_load()中注冊(cè)對(duì)象。內(nèi)置 x264 插件的完整初始化文件只有 16 行obs-x264-plugin-main.c#include obs-module.h OBS_DECLARE_MODULE() OBS_MODULE_USE_DEFAULT_LOCALE(obs-x264, en-US) MODULE_EXPORT const char *obs_module_description(void) { return x264 based encoder; } extern struct obs_encoder_info obs_x264_encoder; bool obs_module_load(void) { obs_register_encoder(obs_x264_encoder); return true; }要點(diǎn)#include obs-module.h會(huì)自動(dòng)引入obs.h而obs.h又自動(dòng)包含obs-encoder.h、obs-data.h、obs-properties.h等所以編碼器插件不需要單獨(dú) include 編碼器頭文件見 plugins.rst 的 Plugin Module Headers 一節(jié)。obs_register_encoder()通常在obs_module_load()中調(diào)用。宏obs_register_encoder(info)實(shí)際展開為obs_register_encoder_s(info, sizeof(struct obs_encoder_info))見 obs-encoder.h按結(jié)構(gòu)體大小注冊(cè)以兼容結(jié)構(gòu)體擴(kuò)展。obs_module_load()的返回值就是模塊加載判定返回true繼續(xù)加載模塊返回false表示失敗并觸發(fā)模塊卸載reference-modules.rst。如何驗(yàn)證編碼器注冊(cè)成功文檔提供的驗(yàn)證路徑分兩層模塊加載層面前端通過obs_open_module()打開模塊鏡像通過obs_init_module()觸發(fā)obs_module_load()。obs_open_module會(huì)返回明確的失敗碼包括MODULE_SUCCESS、MODULE_FILE_NOT_FOUND找不到模塊、MODULE_MISSING_EXPORTS缺少必需導(dǎo)出函數(shù)、MODULE_INCOMPATIBLE_VER版本不兼容等obs_init_module返回true表示模塊加載成功。如果你的obs_module_load里注冊(cè)邏輯出錯(cuò)并返回false模塊會(huì)被卸載這一條就是最基本的失敗信號(hào)。編碼器對(duì)象層面注冊(cè)完成后可以用 reference-encoders.rst 中的類型級(jí)接口按id反查編碼器obs_encoder_defaults(id)取默認(rèn)設(shè)置、obs_get_encoder_properties(id)取屬性列表、obs_get_encoder_type(id)確認(rèn)類型最終用obs_video_encoder_create(id, name, settings, hotkey_data)創(chuàng)建編碼器實(shí)例創(chuàng)建失敗會(huì)返回NULL。也就是說obs_video_encoder_create對(duì)你的id能返回非 NULL說明注冊(cè)、create回調(diào)整條鏈路都工作正常。設(shè)置命名約定與能力聲明的邊界文檔plugins.rst 的 IMPORTANT NOTE對(duì)編碼器的通用設(shè)置項(xiàng)給出了命名約定實(shí)現(xiàn)時(shí)應(yīng)遵守以便輸出模塊和前端正確識(shí)別設(shè)置名適用含義bitrate視頻與音頻編碼器碼率單位為千比特kilobitsrate_control視頻編碼器碼率控制方式至少應(yīng)提供 CBR其他常見值為 VBR、CQPkeyint_sec視頻編碼器關(guān)鍵幀間隔單位為秒或最接近的近似值兩條邊界需要明確頭文件注釋obs-encoder.h說明編碼器的使用范圍是有限且特定的一般面向流媒體和錄像場(chǎng)景的 h264/aac 實(shí)現(xiàn)如果你的目標(biāo)不屬于這類用途文檔沒有給出支持承諾。OBS_ENCODER_CAP_SCALING表示編碼器自行實(shí)現(xiàn)縮放邏輯、希望接收未縮放的輸入幀OBS_ENCODER_CAP_ROI表示支持感興趣區(qū)域ROI自 30.1 版本引入見 reference-encoders.rst 的obs_encoder_roi部分。這些能力標(biāo)志聲明后對(duì)應(yīng)的行為如 ROI 區(qū)域在開啟縮放時(shí)按縮放后尺寸回調(diào)由 libobs 按聲明調(diào)用不能只聲明標(biāo)志而不在實(shí)現(xiàn)中處理。完成以上步驟后你的編碼器插件在 OBS 構(gòu)建中作為MODULE動(dòng)態(tài)庫(kù)產(chǎn)出并隨插件目錄安裝前端加載插件目錄中的模塊文件即會(huì)觸發(fā)注冊(cè)后續(xù)深入可參考 obs-outputs 插件 中消費(fèi)編碼后 packet 的輸出實(shí)現(xiàn)理解編碼數(shù)據(jù)如何流向最終輸出?！久赓M(fèi)下載鏈接】obs-studioOBS Studio - Free and open source software for live streaming and screen recording項(xiàng)目地址: https://gitcode.com/GitHub_Trending/ob/obs-studio創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 OBS Studio 如何用 obs_encoder_info 實(shí)現(xiàn)自定義視頻編碼器？
OBS Studio 如何用 obs_encoder_info 實(shí)現(xiàn)自定義視頻編碼器【免費(fèi)下載鏈接】obs-studioOBS Studio - Free and open source software for live streaming and screen recording項(xiàng)目地址: https://gitcode.com/GitHub_Trending/ob/obs-studio如果你需要讓 OBS Studio 的推流/錄像輸出支持一個(gè)新的視頻編碼實(shí)現(xiàn)而不是替換整個(gè)輸出模塊正確的做法是編寫一個(gè)插件模塊用obs_encoder_info結(jié)構(gòu)體描述你的編碼器并在模塊加載時(shí)注冊(cè)到 libobs。本文基于倉(cāng)庫(kù)內(nèi)的 插件開發(fā)文檔、編碼器 API 參考 以及內(nèi)置的 obs-x264 編碼器插件 源碼給出從定義編碼器結(jié)構(gòu)到注冊(cè)、構(gòu)建、驗(yàn)證的完整路徑。適用前提你能編譯 C/C 代碼并構(gòu)建 OBS 插件模塊插件機(jī)制文檔位于 docs/sphinx/plugins.rst編碼器專用頭文件是 libobs/obs-encoder.h。官方文檔說明編碼器的定位是OBS 專用的音視頻編碼器實(shí)現(xiàn)配合使用編碼器的輸出工作通常面向 h264/aac 這類流媒體與錄像場(chǎng)景。插件模塊的目錄結(jié)構(gòu)與 CMake 構(gòu)建插件模塊可以實(shí)現(xiàn)的 libobs 對(duì)象包括 sources、outputs、encoders 和 services。文檔給出的常規(guī)組織方式是一個(gè)文件負(fù)責(zé)插件初始化另外的文件分別定義各對(duì)象。對(duì)只包含一個(gè)編碼器的最小插件目錄可以是my-encoder-plugin/data/locale/en-US.ini my-encoder-plugin/CMakeLists.txt my-encoder-plugin/my-plugin.c my-encoder-plugin/my-encoder.c對(duì)應(yīng)的 CMakeLists.txt文檔示例見 plugins.rst# my-plugin/CMakeLists.txt project(my-plugin) set(my-plugin_SOURCES my-plugin.c my-encoder.c) add_library(my-plugin MODULE ${my-plugin_SOURCES}) target_link_libraries(my-plugin libobs) install_obs_plugin_with_data(my-plugin data)如果編碼器依賴第三方編解碼庫(kù)可以參考內(nèi)置 x264 插件的真實(shí) CMakeLists.txtcmake_minimum_required(VERSION 3.28...3.30) find_package(Libx264 REQUIRED) if(NOT TARGET OBS::opts-parser) add_subdirectory(${CMAKE_SOURCE_DIR}/shared/opts-parser ${CMAKE_BINARY_DIR}/shared/opts-parser) endif() add_library(obs-x264 MODULE) add_library(OBS::x264 ALIAS obs-x264) target_sources(obs-x264 PRIVATE obs-x264.c obs-x264-plugin-main.c) target_link_libraries(obs-x264 PRIVATE OBS::opts-parser Libx264::Libx264)它展示了三個(gè)要點(diǎn)用find_package定位外部依賴Libx264 REQUIRED、用add_library(... MODULE)產(chǎn)出動(dòng)態(tài)庫(kù)、用target_link_libraries鏈接依賴。填寫 obs_encoder_info 結(jié)構(gòu)體編碼器定義集中在 libobs/obs-encoder.h 的struct obs_encoder_info。按頭文件注釋字段分為Required implementation必選和Optional implementation可選兩部分必選字段字段說明id編碼器唯一字符串標(biāo)識(shí)文檔明確標(biāo)注 requiredtype編碼器類型視頻編碼器填OBS_ENCODER_VIDEO音頻填OBS_ENCODER_AUDIOcodec編解碼器字符串如 h264get_name返回編碼器的可翻譯名稱create用 settings 創(chuàng)建實(shí)現(xiàn)數(shù)據(jù)初始化失敗返回 NULLdestroy銷毀實(shí)現(xiàn)數(shù)據(jù)encode編碼音視頻幀輸出encoder_packetget_frame_size僅音頻編碼器使用返回每幀的采樣數(shù)如 AAC 為 1024可選字段視頻編碼器常用的get_defaults在 settings 上調(diào)用obs_data_set_default*系列函數(shù)設(shè)置默認(rèn)值、get_properties生成屬性列表前端可據(jù)此自動(dòng)生成設(shè)置界面、update更新設(shè)置通常用于運(yùn)行中改變碼率、get_extra_data通常返回編碼器頭數(shù)據(jù)、get_sei_data返回 SEI 數(shù)據(jù)、get_video_info告知后端輸入視頻需要轉(zhuǎn)換的格式或尺寸、caps能力標(biāo)志按位或組合。caps的取值直接來自 obs-encoder.h#define OBS_ENCODER_CAP_DEPRECATED (1 0) #define OBS_ENCODER_CAP_PASS_TEXTURE (1 1) #define OBS_ENCODER_CAP_DYN_BITRATE (1 2) #define OBS_ENCODER_CAP_INTERNAL (1 3) #define OBS_ENCODER_CAP_ROI (1 4) #define OBS_ENCODER_CAP_SCALING (1 5) #define OBS_ENCODER_CAP_MULTITRACK_DYN_BITRATE (1 6)文檔給出的最小示例編碼器示例代碼來自 plugins.rst/* my-encoder.c */ struct obs_encoder_info my_encoder { .id my_encoder, .type OBS_ENCODER_VIDEO, .codec h264, .get_name my_encoder_name, .create my_encoder_create, .destroy my_encoder_destroy, .encode my_encoder_encode, .update my_encoder_update, .get_extra_data my_encoder_extra_data, .get_sei_data my_encoder_sei_data, .get_video_info my_encoder_video_info };對(duì)照內(nèi)置 x264 編碼器的真實(shí)注冊(cè)結(jié)構(gòu)obs-x264.c可以看到完整字段組合struct obs_encoder_info obs_x264_encoder { .id obs_x264, .type OBS_ENCODER_VIDEO, .codec h264, .get_name obs_x264_getname, .create obs_x264_create, .destroy obs_x264_destroy, .encode obs_x264_encode, .update obs_x264_update, .get_properties obs_x264_props, .get_defaults obs_x264_defaults, .get_extra_data obs_x264_extra_data, .get_sei_data obs_x264_sei, .get_video_info obs_x264_video_info, .caps OBS_ENCODER_CAP_DYN_BITRATE | OBS_ENCODER_CAP_ROI, };兩個(gè)實(shí)現(xiàn)細(xì)節(jié)值得注意get_properties的data參數(shù)可能為 NULL——當(dāng)對(duì)編碼器類型而不是某個(gè)實(shí)例調(diào)用obs_get_encoder_properties()時(shí)會(huì)發(fā)生文檔要求實(shí)現(xiàn)方妥善處理這一情況。encode的返回值語義true表示成功false表示 critical failure嚴(yán)重失敗。encode 回調(diào)與 encoder_packetencode的原型是bool (*encode)(void *data, struct encoder_frame *frame, struct encoder_packet *packet, bool *received_packet)。輸入幀結(jié)構(gòu) encoder_frame 包含原始數(shù)據(jù)平面data[MAX_AV_PLANES]、每個(gè)平面的行步長(zhǎng)linesize、音頻幀數(shù)frames僅音頻和呈現(xiàn)時(shí)間戳pts。輸出要填寫 encoder_packet其中由編碼器實(shí)現(xiàn)方負(fù)責(zé)設(shè)置的字段是data、size、pts、dts、timebase_num、timebase_den、type填OBS_ENCODER_VIDEO和keyframe。文檔明確標(biāo)注以下字段should not be set by the encoder implementation由 libobs 內(nèi)部填充dts_usec、sys_dts_usec、priority已不再使用、drop_priority、track_idx、encoder。*received_packet需要你在每次調(diào)用中顯式設(shè)置本次調(diào)用是否產(chǎn)出了一個(gè) packet。內(nèi)置 x264 編碼器的處理方式obs-x264.c*received_packet (nal_count ! 0); parse_packet(obsx264, packet, nals, nal_count, pic_out); return true;即按實(shí)際產(chǎn)出的 NAL 數(shù)量決定是否置位received_packet隨后填充 packet 并返回true。另外如果編碼器運(yùn)行中會(huì)輸出頭數(shù)據(jù)如 SPS/PPS實(shí)現(xiàn)get_extra_data返回true并填好extra_data與size沒有頭數(shù)據(jù)時(shí)返回false。x264 的實(shí)現(xiàn)obs-x264.c就是在上下文存在時(shí)返回緩存的extra_data否則返回false。在 obs_module_load 中注冊(cè)編碼器插件初始化文件的職責(zé)是聲明模塊并在obs_module_load()中注冊(cè)對(duì)象。內(nèi)置 x264 插件的完整初始化文件只有 16 行obs-x264-plugin-main.c#include obs-module.h OBS_DECLARE_MODULE() OBS_MODULE_USE_DEFAULT_LOCALE(obs-x264, en-US) MODULE_EXPORT const char *obs_module_description(void) { return x264 based encoder; } extern struct obs_encoder_info obs_x264_encoder; bool obs_module_load(void) { obs_register_encoder(obs_x264_encoder); return true; }要點(diǎn)#include obs-module.h會(huì)自動(dòng)引入obs.h而obs.h又自動(dòng)包含obs-encoder.h、obs-data.h、obs-properties.h等所以編碼器插件不需要單獨(dú) include 編碼器頭文件見 plugins.rst 的 Plugin Module Headers 一節(jié)。obs_register_encoder()通常在obs_module_load()中調(diào)用。宏obs_register_encoder(info)實(shí)際展開為obs_register_encoder_s(info, sizeof(struct obs_encoder_info))見 obs-encoder.h按結(jié)構(gòu)體大小注冊(cè)以兼容結(jié)構(gòu)體擴(kuò)展。obs_module_load()的返回值就是模塊加載判定返回true繼續(xù)加載模塊返回false表示失敗并觸發(fā)模塊卸載reference-modules.rst。如何驗(yàn)證編碼器注冊(cè)成功文檔提供的驗(yàn)證路徑分兩層模塊加載層面前端通過obs_open_module()打開模塊鏡像通過obs_init_module()觸發(fā)obs_module_load()。obs_open_module會(huì)返回明確的失敗碼包括MODULE_SUCCESS、MODULE_FILE_NOT_FOUND找不到模塊、MODULE_MISSING_EXPORTS缺少必需導(dǎo)出函數(shù)、MODULE_INCOMPATIBLE_VER版本不兼容等obs_init_module返回true表示模塊加載成功。如果你的obs_module_load里注冊(cè)邏輯出錯(cuò)并返回false模塊會(huì)被卸載這一條就是最基本的失敗信號(hào)。編碼器對(duì)象層面注冊(cè)完成后可以用 reference-encoders.rst 中的類型級(jí)接口按id反查編碼器obs_encoder_defaults(id)取默認(rèn)設(shè)置、obs_get_encoder_properties(id)取屬性列表、obs_get_encoder_type(id)確認(rèn)類型最終用obs_video_encoder_create(id, name, settings, hotkey_data)創(chuàng)建編碼器實(shí)例創(chuàng)建失敗會(huì)返回NULL。也就是說obs_video_encoder_create對(duì)你的id能返回非 NULL說明注冊(cè)、create回調(diào)整條鏈路都工作正常。設(shè)置命名約定與能力聲明的邊界文檔plugins.rst 的 IMPORTANT NOTE對(duì)編碼器的通用設(shè)置項(xiàng)給出了命名約定實(shí)現(xiàn)時(shí)應(yīng)遵守以便輸出模塊和前端正確識(shí)別設(shè)置名適用含義bitrate視頻與音頻編碼器碼率單位為千比特kilobitsrate_control視頻編碼器碼率控制方式至少應(yīng)提供 CBR其他常見值為 VBR、CQPkeyint_sec視頻編碼器關(guān)鍵幀間隔單位為秒或最接近的近似值兩條邊界需要明確頭文件注釋obs-encoder.h說明編碼器的使用范圍是有限且特定的一般面向流媒體和錄像場(chǎng)景的 h264/aac 實(shí)現(xiàn)如果你的目標(biāo)不屬于這類用途文檔沒有給出支持承諾。OBS_ENCODER_CAP_SCALING表示編碼器自行實(shí)現(xiàn)縮放邏輯、希望接收未縮放的輸入幀OBS_ENCODER_CAP_ROI表示支持感興趣區(qū)域ROI自 30.1 版本引入見 reference-encoders.rst 的obs_encoder_roi部分。這些能力標(biāo)志聲明后對(duì)應(yīng)的行為如 ROI 區(qū)域在開啟縮放時(shí)按縮放后尺寸回調(diào)由 libobs 按聲明調(diào)用不能只聲明標(biāo)志而不在實(shí)現(xiàn)中處理。完成以上步驟后你的編碼器插件在 OBS 構(gòu)建中作為MODULE動(dòng)態(tài)庫(kù)產(chǎn)出并隨插件目錄安裝前端加載插件目錄中的模塊文件即會(huì)觸發(fā)注冊(cè)后續(xù)深入可參考 obs-outputs 插件 中消費(fèi)編碼后 packet 的輸出實(shí)現(xiàn)理解編碼數(shù)據(jù)如何流向最終輸出?！久赓M(fèi)下載鏈接】obs-studioOBS Studio - Free and open source software for live streaming and screen recording項(xiàng)目地址: https://gitcode.com/GitHub_Trending/ob/obs-studio創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考