इस लेख में मैं VLC मीडिया प्लेयर के लिए C में एक प्लगइन लिखने के तरीके के बारे में बात करूंगा। मैंने अंग्रेजी में टीवी शो और फिल्मों को देखने के लिए अपने प्लगइन को लिखा। इस प्लगइन को बनाने का विचार आइडिया और फाइंडिंग सॉल्यूशंस के सेक्शन में वर्णित है। प्लगइन कार्यान्वयन के तकनीकी विवरण हैलो वर्ल्ड प्लगइन और कार्यान्वयन अनुभागों में दिए गए हैं। अंत में क्या हुआ और इसे कैसे उपयोग किया जाए, यह अंतिम अनुभाग में पाया जा सकता है, परिणाम ।

प्रोजेक्ट के लिए सोर्स कोड GitHub पर उपलब्ध है ।

विचार

मेरी पसंदीदा श्रृंखला देखने के दौरान एक विदेशी भाषा सीखने का विचार नया नहीं है, लेकिन मुझे व्यक्तिगत रूप से इसके साथ हमेशा समस्या रही है। श्रृंखला या फिल्म देखना बहुत मुश्किल है जब आप जो कहते हैं उसका आधा समझ नहीं पाते हैं। बेशक, आप उपशीर्षक को चालू कर सकते हैं, लेकिन अगर किसी भाषण में कोई अपरिचित शब्द या अभिव्यक्ति का सामना करना पड़ता है, तो यह स्पष्ट नहीं हो जाएगा कि यह पाठ द्वारा दोहराया जाएगा। और मुझे रूसी उपशीर्षक के साथ श्रृंखला देखना बिल्कुल पसंद नहीं था - मस्तिष्क अपनी मूल भाषा पर स्विच करता है और विदेशी भाषण का अनुभव करना बंद कर देता है। मैंने कहीं पढ़ा कि पहले आपको रूसी में एक श्रृंखला देखने की जरूरत है, और फिर मूल में। लेकिन यह तरीका मुझे पसंद नहीं आया। सबसे पहले, जहां एक ही चीज़ को देखने के लिए कई बार इतना समय लगता है, और दूसरी बार, दूसरी बार देखने के लिए अब इतना दिलचस्प नहीं है - प्रेरणा खो जाती है।

विदेशी टीवी शो देखने के साथ सभी कठिनाइयों के बावजूद, मैं अंग्रेजी में तकनीकी दस्तावेज, लेख और किताबें पढ़ सकता हूं। मुझे किंडल इलेक्ट्रॉनिक रीडर पर किताबें पढ़ना पसंद है, क्योंकि डिक्शनरी फ़ंक्शन वहाँ ठंडा है - आप स्क्रीन के एक स्पर्श से अपरिचित शब्द का अनुवाद पा सकते हैं। ब्राउज़र में अनुवाद के लिए एक विशेष एक्सटेंशन स्थापित करके अंग्रेजी-भाषा के लेखों और साइटों को पढ़ना सुविधाजनक है - मैं Yandex.Translation एक्सटेंशन का उपयोग करता हूं । यह दृष्टिकोण आपको अपरिचित शब्दों की खोज के लिए बहुत व्याकुलता के बिना, अंग्रेजी ग्रंथों को पढ़ने और समझने की अनुमति देता है।

मैंने सोचा, टीवी शो देखने के लिए समान दृष्टिकोण क्यों नहीं लागू किया जाता है - हम अंग्रेजी में श्रृंखला को चालू करते हैं जैसे ही एक असंगत वाक्यांश पाया जाता है, रूसी ऑडियो ट्रैक पर स्विच करें और थोड़ा पीछे हटें। अगला, हम अंग्रेजी में श्रृंखला देखना जारी रखते हैं।

समाधान के लिए खोजें

वास्तव में, मेरी ज़रूरत की सभी कार्यक्षमता पहले से ही कई लोकप्रिय मीडिया खिलाड़ियों में उपलब्ध है। केवल एक चीज मैं ऑडियो ट्रैक को स्विच करना चाहूंगा और एक बटन के क्लिक के साथ कुछ सेकंड पहले वीडियो को रिवाइंड करूंगा। यह भी बहुत अच्छा होगा अगर, एक असंगत अंश का अनुवाद करने के बाद, मीडिया प्लेयर ने खुद ही ऑडियो ट्रैक को अंग्रेजी में बदल दिया। खैर, अंग्रेजी ट्रैक के साथ पहले से अनुवादित खंड को दोहराने में सक्षम होना अच्छा होगा।

यही है, मुझे एक मीडिया प्लेयर की आवश्यकता है जिसके लिए आप प्लगइन्स लिख सकते हैं। यह भी वांछनीय है कि यह क्रॉस-प्लेटफ़ॉर्म हो, क्योंकि मैं विंडोज के तहत एक पीसी और लिनक्स के तहत एक लैपटॉप का उपयोग करता हूं। मेरी पसंद तुरंत वीएलसी पर गिर गई। हब्र पर मुझे एक लेख भी मिला जिसमें @Idunno बताता है कि कैसे LUA पर VLC एक्सटेंशन लिखना है। वैसे, उन्होंने अंग्रेजी सीखने के लिए यह एक्सटेंशन भी लिखा था) दुर्भाग्य से, यह एक्सटेंशन वीएलसी के नवीनतम संस्करणों में काम नहीं करता है (5.5% से अधिक)। अस्थिर संचालन के कारण, कॉलबैक फ़ंक्शंस जोड़ने की क्षमता जिसके माध्यम से LUA एक्सटेंशन में कीबोर्ड ईवेंट को संसाधित करना संभव था, LUA API से हटा दिया गया था। README में , इस समस्या पर चर्चा करने वाले VLC डेवलपर्स की मेलिंग सूची का एक लिंक GitHub @Idunno पर इसके विस्तार की ओर जाता है।

इस प्रकार, मेरे विचार को लागू करने के लिए, एलयूए के लिए एक एक्सटेंशन काम नहीं करता है, आपको सी में एक प्लगइन लिखने की आवश्यकता है और हालांकि मैंने सी में आखिरी बार 7 साल पहले विश्वविद्यालय में कुछ लिखा था, मैंने इसे आज़माने का फैसला किया।

हैलो दुनिया प्लगइन

यह ध्यान देने योग्य है कि वीएलसी मीडिया प्लेयर के पास बहुत अच्छे दस्तावेज हैं । मैंने इससे सीखा कि मीडिया प्लेयर का विकास एक मॉड्यूलर दृष्टिकोण का उपयोग करता है। वीएलसी में कई स्वतंत्र मॉड्यूल होते हैं जो कुछ कार्यक्षमता को लागू करते हैं, और कर्नेल ( libVLCCore ), जो इन मॉड्यूल का प्रबंधन करता है। दो प्रकार के मॉड्यूल हैं: आंतरिक ( इन-ट्री ) और बाहरी ( आउट-ऑफ-ट्री )। आंतरिक मॉड्यूल के स्रोत कोड को कर्नेल कोड के साथ एक भंडार में संग्रहीत किया जाता है। बाहरी मॉड्यूल VLC मीडिया प्लेयर के स्वतंत्र रूप से विकसित और इकट्ठे होते हैं। दरअसल, बाद वाले हैं जिन्हें प्लगइन्स कहा जाता है।

प्रलेखन में सी में अपना प्लग-इन (मॉड्यूल) लिखने का तरीका भी है। यह लेख एक साधारण प्लग-इन का स्रोत कोड प्रदान करता है, जब VLC शुरू होता है, कंसोल में एक स्वागत संदेश " नमस्कार, <name> " प्रदर्शित करता है (मान <name) लिया जाता है। प्लगइन सेटिंग्स से)। थोड़ा आगे बढ़ते हुए, मैं कहूंगा कि उपरोक्त उदाहरण में, set_category(CAT_INTERFACE) बाद निम्न पंक्ति जोड़ें:

 set_subcategory( SUBCAT_INTERFACE_CONTROL )

खैर, जो कुछ भी बचा है वह प्लग-इन को इकट्ठा करने और इसके संचालन का परीक्षण करने के लिए है। एक बाहरी प्लगइन के निर्माण के लिए एक निर्देश भी है। यहां यह अंतर्राष्ट्रीयकरण अनुभाग पर ध्यान देने योग्य है, जो बताता है कि वीएलसी में स्थानीयकरण कैसे काम करता है। संक्षेप में, बाहरी प्लग-इन के लिए आपको मैक्रोज़ N_() , _() को परिभाषित करना होगा:

 #define DOMAIN "vlc-myplugin" #define _(str) dgettext(DOMAIN, str) #define N_(str) (str)

असेंबली के लिए, अच्छे पुराने मेकफाइल या ऑटोटूल का उपयोग करने का प्रस्ताव है। मैंने सरल तरीके से जाने का फैसला किया और मेकफाइल को चुना। Makefile में आपको MODULE_STRING चर को परिभाषित करने के लिए याद रखने की आवश्यकता है - यह हमारे प्लगइन का पहचानकर्ता है। मैंने निर्देशिकाओं के साथ काम को थोड़ा बदल दिया - अब उन्हें pkg-config के माध्यम से परिभाषित किया गया है। परिणाम निम्न फ़ाइलें है:

hello.c

 /** * @file hello.c * @brief Hello world interface VLC module example */ #ifdef HAVE_CONFIG_H # include "config.h" #endif #define DOMAIN "vlc-myplugin" #define _(str) dgettext(DOMAIN, str) #define N_(str) (str) #include <stdlib.h> /* VLC core API headers */ #include <vlc_common.h> #include <vlc_plugin.h> #include <vlc_interface.h> /* Forward declarations */ static int Open(vlc_object_t *); static void Close(vlc_object_t *); /* Module descriptor */ vlc_module_begin() set_shortname(N_("Hello")) set_description(N_("Hello interface")) set_capability("interface", 0) set_callbacks(Open, Close) set_category(CAT_INTERFACE) set_subcategory( SUBCAT_INTERFACE_CONTROL ) add_string("hello-who", "world", "Target", "Whom to say hello to.", false) vlc_module_end () /* Internal state for an instance of the module */ struct intf_sys_t { char *who; }; /** * Starts our example interface. */ static int Open(vlc_object_t *obj) { intf_thread_t *intf = (intf_thread_t *)obj; /* Allocate internal state */ intf_sys_t *sys = malloc(sizeof (*sys)); if (unlikely(sys == NULL)) return VLC_ENOMEM; intf->p_sys = sys; /* Read settings */ char *who = var_InheritString(intf, "hello-who"); if (who == NULL) { msg_Err(intf, "Nobody to say hello to!"); goto error; } sys->who = who; msg_Info(intf, "Hello %s!", who); return VLC_SUCCESS; error: free(sys); return VLC_EGENERIC; } /** * Stops the interface. */ static void Close(vlc_object_t *obj) { intf_thread_t *intf = (intf_thread_t *)obj; intf_sys_t *sys = intf->p_sys; msg_Info(intf, "Good bye %s!", sys->who); /* Free internal state */ free(sys->who); free(sys); }

makefile

 LD = ld CC = cc PKG_CONFIG = pkg-config INSTALL = install CFLAGS = -g -O2 -Wall -Wextra LDFLAGS = LIBS = VLC_PLUGIN_CFLAGS := $(shell $(PKG_CONFIG) --cflags vlc-plugin) VLC_PLUGIN_LIBS := $(shell $(PKG_CONFIG) --libs vlc-plugin) VLC_PLUGIN_DIR := $(shell $(PKG_CONFIG) --variable=pluginsdir vlc-plugin) plugindir = $(VLC_PLUGIN_DIR)/misc override CC += -std=gnu99 override CPPFLAGS += -DPIC -I. -Isrc override CFLAGS += -fPIC override LDFLAGS += -Wl,-no-undefined,-z,defs override CPPFLAGS += -DMODULE_STRING=\"hello\" override CFLAGS += $(VLC_PLUGIN_CFLAGS) override LIBS += $(VLC_PLUGIN_LIBS) all: libhello_plugin.so install: all mkdir -p -- $(DESTDIR)$(plugindir) $(INSTALL) --mode 0755 libhello_plugin.so $(DESTDIR)$(plugindir) install-strip: $(MAKE) install INSTALL="$(INSTALL) -s" uninstall: rm -f $(plugindir)/libhello_plugin.so clean: rm -f -- libhello_plugin.so src/*.o mostlyclean: clean SOURCES = hello.c $(SOURCES:%.c=src/%.o): $(SOURCES:%.c=src/%.c) libhello_plugin.so: $(SOURCES:%.c=src/%.o) $(CC) $(LDFLAGS) -shared -o $@ $^ $(LIBS) .PHONY: all install install-strip uninstall clean mostlyclean

लिनक्स के लिए एक प्लगइन बनाने का सबसे आसान तरीका। ऐसा करने के लिए, आपको स्थापित करने की आवश्यकता है, वास्तव में, वीएलसी मीडिया प्लेयर, साथ ही प्लग-इन के निर्माण के लिए आवश्यक फाइलें और उपकरण। डेबियन / उबंटू पर, यह निम्नलिखित कमांड के साथ किया जा सकता है:

 sudo apt-get install vlc libvlc-dev libvlccore-dev gcc make pkg-config

दरअसल, सब कुछ तैयार है, हम कमांड का उपयोग करके अपने प्लगइन को इकट्ठा और स्थापित करते हैं:

 sudo make install

प्लगइन का परीक्षण करने के लिए, वीएलसी को कंसोल से भी चलाएं:

vlc

दुर्भाग्य से, हमने कोई " हैलो वर्ल्ड " नहीं देखा। बात यह है कि प्लगइन को पहले सक्षम होना चाहिए। ऐसा करने के लिए, सेटिंग्स खोलें ( टूल > प्राथमिकताएं ), उन्नत दृश्य पर जाएं ( सभी दिखाएँ सेटिंग्स समूह में चयन करें) और बाएं पैनल इंटरफ़ेस में पेड़ में ढूंढें> नियंत्रण इंटरफ़ेस - हमारे हैलो इंटरफ़ेस प्लगइन के बगल में स्थित बॉक्स को चेक करें।

हम सेटिंग्स को सहेजते हैं और वीएलसी को पुनरारंभ करते हैं।

विंडोज के लिए एक प्लगइन बनाएँ

विंडोज के साथ, चीजें थोड़ी अधिक जटिल हैं। प्लगइन का निर्माण करने के लिए, आपको एसडीके डाउनलोड करना होगा, जिसमें वीएलसी की लाइब्रेरी, हेडर और कॉन्फ़िगरेशन फाइलें शामिल हैं। पहले, sdk नियमित VLC असेंबली का हिस्सा था और प्रोग्राम इंस्टॉलेशन फ़ोल्डर में पाया जा सकता था। अब यह एक अलग मीडिया प्लेयर असेंबली के रूप में आता है। उदाहरण के लिए, VLC संस्करण 3.0.8 के लिए, यह असेंबली ftp://ftp.videolan.org/pub/videolan/vlc/3.0.8/win64/vlc-3.0.8-win64.7z पर डाउनलोड की जा सकती है (7z डाउनलोड करना महत्वपूर्ण है --Secondary)।

संग्रह की सामग्री को किसी फ़ोल्डर में कॉपी करें, उदाहरण के लिए, C: \ Projects के लिए । Sdk के अलावा, पुरालेख में स्वयं मीडिया प्लेयर भी है, जिसका उपयोग प्लग-इन का परीक्षण और डीबग करने के लिए किया जा सकता है।

ताकि हमारे मेकफाइल को प्लगइन बनाने और स्थापित करने के लिए इस्तेमाल किया जा सके, आपको फ़ाइल को ठीक करने की आवश्यकता है C: \ Projects \ vlc-3.0.8 \ sdk \ lib \ pkgconfig \ vlc-plugin.pc , उपसर्ग और pluginsdir चर में sdk फ़ोल्डर के लिए सही पथ का संकेत और प्लगइन्स क्रमशः:

 prefix=/c/Projects/vlc-3.0.8/sdk pluginsdir=/c/Projects/vlc-3.0.8/plugins

विंडोज के तहत निर्माण करने के लिए, हमें एक कंपाइलर और अन्य उपयोगिताओं को भी स्थापित करना होगा। MSYS2 वातावरण स्थापित करके सभी आवश्यक सॉफ़्टवेयर प्राप्त किए जा सकते हैं। प्रोजेक्ट वेबसाइट पर विस्तृत इंस्टॉलेशन निर्देश हैं। संक्षेप में, स्थापना के तुरंत बाद आपको कंसोल को खोलने की आवश्यकता है ( C: \ msys64 \ msys2.exe ) और कमांड का उपयोग करके MSYS2 पैकेज को अपडेट करें:

 pacman -Syu

अगला, MSYS2 टर्मिनल विंडो बंद करें, फिर इसे फिर से खोलें और कमांड चलाएं

 pacman -Su

सभी पैकेजों को अपडेट करने के बाद, आपको टूलचिन को इंस्टॉल करना होगा:

 pacman -S base-devel mingw-w64-x86_64-toolchain

अब जब सभी आवश्यक पैकेज स्थापित हो गए हैं, तो आप प्लगइन का निर्माण शुरू कर सकते हैं। मैंने मेकफाइल को थोड़ा संशोधित किया ताकि यह लिनक्स और विंडोज के तहत प्लगइन का निर्माण कर सके। इसके अलावा, मुझे कुछ असमर्थित MinGW बिल्ड मापदंडों को हटाना पड़ा, परिणामस्वरूप मेकफाइल इस तरह दिखना शुरू हुआ:

विंडोज के लिए मेकफाइल

 LD = ld CC = cc PKG_CONFIG = pkg-config INSTALL = install CFLAGS = -g -O2 -Wall -Wextra LDFLAGS = LIBS = VLC_PLUGIN_CFLAGS := $(shell $(PKG_CONFIG) --cflags vlc-plugin) VLC_PLUGIN_LIBS := $(shell $(PKG_CONFIG) --libs vlc-plugin) VLC_PLUGIN_DIR := $(shell $(PKG_CONFIG) --variable=pluginsdir vlc-plugin) plugindir = $(VLC_PLUGIN_DIR)/misc override CC += -std=gnu99 override CPPFLAGS += -DPIC -I. -Isrc override CFLAGS += -fPIC override LDFLAGS += -Wl,-no-undefined override CPPFLAGS += -DMODULE_STRING=\"hello\" override CFLAGS += $(VLC_PLUGIN_CFLAGS) override LIBS += $(VLC_PLUGIN_LIBS) SUFFIX := so ifeq ($(OS),Windows_NT) SUFFIX := dll endif all: libhello_plugin.$(SUFFIX) install: all mkdir -p -- $(DESTDIR)$(plugindir) $(INSTALL) --mode 0755 libhello_plugin.$(SUFFIX) $(DESTDIR)$(plugindir) install-strip: $(MAKE) install INSTALL="$(INSTALL) -s" uninstall: rm -f $(plugindir)/libhello_plugin.$(SUFFIX) clean: rm -f -- libhello_plugin.$(SUFFIX) src/*.o mostlyclean: clean SOURCES = hello.c $(SOURCES:%.c=src/%.o): $(SOURCES:%.c=src/%.c) libhello_plugin.$(SUFFIX): $(SOURCES:%.c=src/%.o) $(CC) $(LDFLAGS) -shared -o $@ $^ $(LIBS) .PHONY: all install install-strip uninstall clean mostlyclean

चूंकि MSYS2 को VLC के लिए हमारे sdk के बारे में कुछ नहीं पता है, इसलिए आपको इस sdk से PKG_CONFIG_PATH पर्यावरण चर में pkgconfig फ़ोल्डर में पथ जोड़ने की आवश्यकता है। MinGW कंसोल खोलें ( C: \ msys64 \ mingw64.exec ) और कमांड निष्पादित करें:

 export PKG_CONFIG_PATH=/c/projects/vlc-3.0.8/sdk/lib/pkgconfig:$PKG_CONFIG_PATH make install

प्लगइन का परीक्षण करने के लिए, वीएलसी को कंसोल से भी चलाएं:

 /c/projects/vlc-3.0.8/vlc

जैसा कि लिनक्स के मामले में, सेटिंग्स पर जाएं और हमारे प्लगइन को चालू करें। हम सेटिंग्स को सहेजते हैं और वीएलसी को पुनरारंभ करते हैं।

प्लगइन कार्यान्वयन

अपने प्लगइन को कार्यान्वित करने के लिए, मुझे यह समझने की आवश्यकता है कि मीडिया प्लेयर को कैसे नियंत्रित किया जाए (ऑडियो ट्रैक बदलें, रिवाइंड करें) और कीबोर्ड कीस्ट्रोक घटनाओं को कैसे संभालना है। यह सब समझने के लिए, मैंने प्रलेखन की ओर रुख किया। इसके अलावा इंटरनेट पर मुझे कुछ दिलचस्प लेख मिले, जो मीडिया प्लेयर की वास्तुकला पर प्रकाश डालते हैं: वीएलसी मीडिया फ्रेमवर्क और वीएलसी मीडिया प्लेयर एपीआई डॉक्यूमेंटेशन की वास्तुकला ।

वीएलसी में बड़ी संख्या में स्वतंत्र मॉड्यूल (400+) होते हैं। प्रत्येक मॉड्यूल को कार्यक्षमता के प्रकार, साथ ही साथ आरंभीकरण / अंतिमकरण कार्यों के बारे में जानकारी प्रदान करनी चाहिए। यह जानकारी vlc_module_begin () - vlc_module_end () ब्लॉक में set_capability () और set_callbacks () मैक्रोज़ का उपयोग करके वर्णित है । मॉड्यूल इनिशियलाइज़ेशन / फ़ाइनलीज़ेशन फ़ंक्शंस (जिसे आमतौर पर ओपन एंड क्लोज़ कहा जाता है) में निम्नलिखित हस्ताक्षर होते हैं:

 static int Open(vlc_object_t *) static void Close(vlc_object_t *)

vlc_object_t VLC में डेटा का प्रतिनिधित्व करने के लिए आधार प्रकार है, जिसमें से अन्य सभी को विरासत में मिला है (लेख Object_Management देखें)। Vlc_object_t के लिए एक प्वाइंटर को मॉड्यूल को लागू करने वाली कार्यक्षमता के अनुसार एक विशिष्ट डेटा प्रकार में डालना होगा। मीडिया प्लेयर को नियंत्रित करने के लिए, मैंने set_capability () मैक्रो में इंटरफ़ेस मान सेट किया है । तदनुसार, ओपन एंड क्लोज फ़ंक्शंस में, मुझे vlc_object_t को intf_thread_t में डालना होगा ।

मॉड्यूल के बीच बातचीत प्रेक्षक डिजाइन पैटर्न पर आधारित है। VLC एक "ऑब्जेक्ट चर" तंत्र प्रदान करता है ( चर देखें), जिसके साथ आप प्रकारों को vlc_object_t (और इसके डेरिवेटिव) के उदाहरणों में जोड़ सकते हैं। मॉड्यूल इन चर के माध्यम से डेटा का आदान-प्रदान कर सकते हैं। आप चर के लिए एक कॉलबैक फ़ंक्शन भी संलग्न कर सकते हैं, जिसे इस चर के मूल्य में परिवर्तन होने पर कहा जाएगा।

उदाहरण के लिए, हॉटकीज़ मॉड्यूल ( मॉड्यूल / नियंत्रण / हॉटकीसेक ) पर विचार करें, जो हॉटकी घटनाओं से निपटने के लिए जिम्मेदार है। ओपन फ़ंक्शन में, ActionEvent कॉलबैक फ़ंक्शन को की -एक्शन चर पर लटका दिया जाता है:

 var_AddCallback( p_intf->obj.libvlc, "key-action", ActionEvent, p_intf );

Vlc_object_t के लिए एक संकेतक, एक चर नाम, एक कॉलबैक फ़ंक्शन और शून्य के लिए एक पॉइंटर को मनमाने ढंग से डेटा पास करने के लिए var_AddCallback फ़ंक्शन को दिया जाता है, जिसे बाद में निर्दिष्ट कॉल फ़ंक्शन को अग्रेषित किया जाता है। कॉलबैक फ़ंक्शन का हस्ताक्षर नीचे दिखाया गया है।

 static int ActionEvent(vlc_object_t *, char const *, vlc_value_t, vlc_value_t, void *)

Vlc_object_t के लिए एक संकेतक, चर का नाम, इस चर के पुराने और नए मूल्यों (इस मामले में, कार्रवाई के संबंधित दबाए गए हॉटकी संयोजन के पहचानकर्ता), साथ ही कॉलबैक फ़ंक्शन को जोड़ते समय किसी भी अतिरिक्त डेटा को इंगित करने वाले को कॉलबैक फ़ंक्शन में पास किया जाता है। ।

हॉटकी घटनाओं का प्रत्यक्ष प्रसंस्करण पुटएक्शन फ़ंक्शन में किया जाता है, जिसे एक्शनइवेंट कॉलबैक फ़ंक्शन के अंदर कहा जाता है। PutAction फ़ंक्शन गर्म कुंजियों ( i_action ) के संयोजन को दबाने की एक घटना के एक पहचानकर्ता को स्वीकार करता है और, स्विच ऑपरेटर की मदद से, संबंधित क्रिया करता है।

उदाहरण के लिए, एक ACTIONID_JUMP_BACKWARD_SHORT घटना ACTIONID_JUMP_BACKWARD_SHORT मेल खाती है। संबंधित क्रिया करने के लिए, रिवाइंड अंतराल को VLC सेटिंग्स (वैरिएबल शॉर्ट-जंप-साइज से ) लिया जाता है:

 mtime_t it = var_InheritInteger( p_input, varname );

खेली जा रही फ़ाइल को रिवाइंड करने के लिए, टाइम-ऑफ़- वैरिएबल को उस समय (माइक्रोसेकंड में) के अनुरूप मान पर सेट करें जिसके द्वारा आप प्लेबैक को शिफ्ट करना चाहते हैं:

 var_SetInteger( p_input, "time-offset", it * sign * CLOCK_FREQ );

फास्ट-फॉरवर्ड के लिए आपको एक सकारात्मक मूल्य निर्दिष्ट करने की आवश्यकता है, फास्ट-रिवर्स के लिए - नकारात्मक। CLOCK_FREQ स्थिरांक का उपयोग सेकंड को माइक्रोसेकंड में बदलने के लिए किया जाता है।

इसी तरह, ऑडियो ट्रैक बदलता है ( ACTIONID_AUDIO_TRACK घटना)। केवल ऑडियो ट्रैक के लिए जिम्मेदार ऑडियो-एस वेरिएबल सीमित मानों को स्वीकार कर सकता है (फ़ाइल में उपलब्ध ऑडियो ट्रैक के अनुसार खेला जा रहा है)। आप var_Change () फ़ंक्शन का उपयोग करके किसी चर के संभावित मानों की सूची प्राप्त कर सकते हैं:

 vlc_value_t list, list2; var_Change( p_input, "audio-es", VLC_VAR_GETCHOICES, &list, &list2 );

मूल्यों की सूची के अलावा, यह फ़ंक्शन आपको इन मूल्यों के विवरणों की एक सूची प्राप्त करने की अनुमति देता है (इस मामले में, ऑडियो ट्रैक्स का नाम)। अब हम var_Set () फ़ंक्शन का उपयोग करके ऑडियो ट्रैक को बदल सकते हैं:

 var_Set( p_input, "audio-es", list.p_list->p_values[i] );

मीडिया प्लेयर का प्रबंधन कैसे करें, यह जानने के लिए कि कीबोर्ड ईवेंट को कैसे संभालना है। दुर्भाग्य से, मैं एक नया हॉटकी नहीं जोड़ सका। सभी हॉटकीज़ को VLC कर्नेल कोड ( src / misc / actions.c ) में हार्डकोड किया गया है। इसलिए, मैंने निचले स्तर के कीबोर्ड कीस्ट्रोक घटनाओं के लिए एक हैंडलर जोड़ा, कुंजी-दबाए गए चर को बदलने के लिए अपने कॉलबैक फ़ंक्शन को लटका दिया:

 var_AddCallback( p_intf->obj.libvlc, "key-pressed", KeyboardEvent, p_intf );

कुंजी-दबाया गया चर अंतिम कुंजी के अनुरूप वर्ण कोड (यूनिकोड में) संग्रहीत करता है। उदाहरण के लिए, जब आप "1" नंबर के साथ कुंजी दबाते हैं, तो कुंजी दबाए गए चर को मान 49 (0x00000031 को 16 वें नंबर सिस्टम में) सौंपा जाएगा। आप अन्य चरित्र कोड unicode-table.com पर देख सकते हैं। इसके अलावा, कुंजी-दबाए गए चर का मूल्य संशोधक कुंजियों के दबाव को ध्यान में रखता है, उनके लिए चौथा महत्वपूर्ण बाइट आवंटित किया गया है। इसलिए, उदाहरण के लिए, " Ctrl + 1 " कुंजी संयोजन दबाते समय , कुंजी दबाए गए चर का मान 0x 04 000031 (00000 1 00 00000000 00000000 00110001 ₂ ) निर्दिष्ट किया जाएगा। स्पष्टता के लिए, नीचे दी गई तालिका विभिन्न प्रमुख संयोजनों का अर्थ बताती है:

कीबोर्ड शॉर्टकट	मूल्य
Ctrl + 1	00000 1 00 00000000 00000000 00110001 ₂
Alt + 1	0000000 1 00000000 00000000 00110001 ₂
Ctrl + Alt + १	00000 1 0 1 00000000 00000000 00110001 ₂
शिफ्ट + 1	000000 1 0 00000000 00000000 00100001 ₂

" Shift + 1 " संयोजन को दबाते समय मूल्य पर ध्यान दें। चूंकि इस मामले में " ! ", फिर पहली बाइट का मूल्य इस चरित्र के कोड के यूनिकोड (0x00000021) में होगा।

परिणाम

मैंने अपने TIP प्लगइन को "ट्रांसलेट इट, प्लीज" वाक्यांश के लिए एक संक्षिप्त नाम दिया, टिप का अनुवाद "संकेत" के रूप में भी किया जा सकता है। प्लगइन का स्रोत कोड GitHub पर प्रकाशित हुआ है , जहां आप विंडोज और लिनक्स के लिए तैयार प्लग-इन असेंबलियों को भी डाउनलोड कर सकते हैं।

प्लगइन को स्थापित करने के लिए, आपको libtip_plugin.dll फ़ाइल (Linux के लिए libtip_plugin.so) को <path-to-vlc> / plugins फ़ोल्डर में कॉपी करना होगा। Windows पर, VLC आमतौर पर C: \ Program Files \ VideoLAN \ VLC फ़ोल्डर में स्थापित होता है। लिनक्स पर, आप कमांड का उपयोग करके इंस्टॉलेशन फ़ोल्डर पा सकते हैं:

 whereis vlc

उदाहरण के लिए, उबंटू में, वीएलसी / usr / lib / x86_64-linux-gnu / vlc में स्थापित है ।

इसके बाद, आपको वीएलसी को फिर से शुरू करना होगा, फिर मेन मेन्यू ओपन टूल्स > प्रेफरेंस में , एडवांस्ड व्यू पर स्विच करें (ऑल्ट इन द शो सेटिंग्स ग्रुप), बाएं पैनल में इंटरफेस > कंट्रोल सेक्शन में जाएं और टीआईपी (इसके बाद ट्रांसलेशन करें, प्लीज) के आगे वाले बॉक्स को चेक करें। फिर फिर से आपको वीएलसी को पुनरारंभ करना होगा।

प्लगइन सेटिंग्स में, आप मुख्य और सहायक (अनुवाद के लिए) ऑडियो पटरियों की संख्या, साथ ही समय (सेकंड में) निर्दिष्ट कर सकते हैं जिसके द्वारा प्लगइन सहायक ऑडियो ट्रैक के साथ दोहराने के लिए रिवाइंड करेगा।

प्लगइन को नियंत्रित करने के लिए, मैंने निम्नलिखित कीबोर्ड शॉर्टकट जोड़े:

" / " अनुवाद के लिए
मुख्य ऑडियो ट्रैक के साथ पहले अनुवादित वीडियो टुकड़े को दोहराने के लिए " Shift + / "

अनुवाद और रीट्री कमांड के निष्पादन के दौरान, प्लगइन क्रमशः ऊपरी बाएं कोने में "TIP: Translate" और "TIP: repeat" संदेशों को प्रदर्शित करता है।

प्लगइन का उपयोग करने के अपने अनुभव से, मैं कह सकता हूं कि सामान्य तौर पर, मैं परिणाम से प्रसन्न हूं। मुख्य बात यह है कि सही सामग्री चुनना है, अगर कम से कम आधे विदेशी भाषण का उपयोग किया जाता है, तो प्लगइन बाकी को अनुवाद करने में मदद करेगा। अन्यथा, प्लगइन शायद बेकार हो जाएगा।

अंग्रेजी सीखने के लिए VLC प्लगइन लिखना