那今天呢?我给大家介绍一下web rtc的接口宏,那之所以在现成的章节中要介绍接口宏。是由于接口在调用的过程中啊,会发生线程的切换,所以把接口宏这部分知识我们放在线程这一章还算比较合适的。
那另外呢,我们对于接口宏的介绍可能要花费三节到四节的时间,那之所以要用这么大的篇幅来介绍接口宏,是由于接口宏本身是比较复杂的。里边儿涉及到了红的定义,红的展开,如何阅读红代码?
那这些知识呢?对于大多数同学来说呢,可能平常用的不多,所以对这块儿代码都不太熟悉。那这里呢,我就多花一点时间给大家介绍清楚,那以使大家在阅读代码的时候呢,更加便利一些,那对于web rtc来说,哪些是接口宏呢?
实际上,我们在peer connection端用到的大多数的接口都是用宏定义来实现的。那比如说我们调用的create peer connection,create audio track等等,这一系列的与stream track相关的API。
都是外rtc通过宏来实现的,那当我们调用它的时候呢?它首先通过这层宏实现的这个代理类。来去调到代理类中的函数,那再通过一系列的操作,最终呢,才到web rtc真正的核心层去执行相关的逻辑。
之所以要设计的这么复杂,它是有一定原因的,那这个原因呢?我在后边的课程中呢,再向你做详细介绍。那今天呢?我们主要来看一下web rtc是如何定义代理类以及如何定义它要暴露的接口了,如果是我们自己修改web rtc,
我们自己该如何定义这些接口?那首先呢,我们来看一下,对于y8 tc来说,它要定义一个外部接口类,它是如何定义的?首先呢,它提供了几个宏?第一个红呢是begin signaling proxy map,这是我们定义外部接口代理类的一个头。
那只要我们看到这样一个头,什么什么什么proxy map就证明是web rtc定义的一个代理类。那宏后边这括号里呢,是我们定义的要对哪个类实现一个代理,那这里写的就是peer connection factory,
也就是对这个类在它的外层呢,再做一层代理类。那第二个也就是它的析构函数,如果我们要对我们定义的这个代理类的析构函数进行隐藏的话,我们需要加入这个宏。也就是proxy signaling第三个呢?是在类中,我们要实现一些方法,那在这里呢?proxy method后边这个数字。数字是几?就说明这个方法,它有几个输入参数,那比如说像peer connection factory,它定义的这个create peer connection。
这个方法它一共有四个数,参数后边就紧跟着四个参数,第一个,第二个,第三个,第四个。那它的返回值呢?实际是这个,这是在代理类中定义一个方法,那当这个类结束之后呢?我们要调用and proxy map来结束这个代理类的定义。那通过这样一个定义啊,它就实现了一个代理类,那代理类中包含的方法呢,可以有多可以有少,
那在这里呢,只有一个。当然,实际的代理类中有好几个我这里只列出了一个,这里你有几个method,它就有几个方法。那通过这几条语句,我们就可以实现一个peer connection factory类的,代理类的实现,那我们再看一个啊。那在这里呢,还是通过某某某proxy map实现了一个的这个代理类。但这里的这个某某某proxy map与我们前面的这个就有一些差别了,那中间我们可以看到在前面第一个介绍的例子中呢,里边有一个signaling。
那第二个中呢?是没有的,那说明一个什么问题呢?就是说明我们第一个类,它只能使用signaling线程。而没有signaling关键字的这个cm AP呢,它是可以支持signaling和working两个线程的。所以这是它们的一个区别,那除此之外呢,对于我们的方法来说,那也可以包含多种方法,第一个方法,后边这个数字代表get。这个函数呢,它只有一个参数,
就是这个参数,而第二个方法呢proxy worker method two说明什么呢?说明我们这个方法是在工作线程中执行的,那如果这里signaling是就说明它是在signaling线程中信令线程中执行的。如果是worker呢,就说明它是在worker线程中执行的,那对于这个函数,它的函数名是什么呢?就是i do。它有两个输入参数,一个是另外一个呢?是那它的返回值呢?是一个void。那最后呢,再通过and proxy map来给它结束掉,
那通过这两个例子啊,我相信你已经知道web rtc是如何通过宏来定义代理类的了。当然,对于代理类的宏实现后的样子,后边我还会向你做详细介绍,那现在我们只要知道web rtc,它是通过这几个宏来定义一个类的代理类的。
那了解了这些知识之后呢?下面我们就可以自己定义一个代理类了,但是我们在定义代理类的时候,也就是说定义我们自己的外部接口的时候。它是有一定规范的,你必须按照这个步骤来去做,才能最终实现你的接口暴露给外层应用。也就是说,
外层应用才能通过你的接口调入到中,那第一步呢,就是实现接口文件,也就是说我们要为一个类。通过宏定义,它的代理类,我们必须让它继承自这个一个接口文件,那接口文件的名字一般怎么写呢?就是某某某interface,所以我们在定义接口的时候呢,我们第一步要实现一个接口类,它的名字就是你的原来的这个类的,这个名字加上一个interface。在这里边儿呢,我们可以定义几个突出的方法,
这是我们要暴露给外边儿的,那外边儿呢,只要通过调用这几个接口儿就可以调入到我们外边儿tc那份儿中来,实现它自己的逻辑。我这里是test类,对吧?就是test interface好第二步呢,是外部rtc,内部要实现这个接口类,那比如我这里介绍这个task这个类。它是继承自哪儿呢?继承自task interface,也就是说在我这个类中要实现这两个接口,那最终呢,当外层调入进来之后。
它才会真正到外边儿tc内部去执行你实现的这两个函数,这是第二步,那第三步呢,就是我们要通过宏来给它定义一个接口类了。
就begin proxy map,如果你是在新定线程中执行的,你应该加一个signaling proxy map。如果不加的呢,就是既可以在新的线程中执行,也有可能在work线程中执行,这括号里的名字呢,就是我们的类名test。我们给它定义一个七个函数signaling three的,也就是说在信令线程中执行的七个函数。那对于这个类来说呢,
它有两个方法,一个是func 1,一个是func 2,那对于第一个来说呢?它是可以在任何线程中执行的,所以呢,没有加线程的名字,并且呢,它没有输入参数。所以就是类型的返回值funce,而第二个方法呢,它是明确要求在worker线程中执行的。那也没有输入参数,所以呢,是string func two,
最后呢,通过and proxy map,那将这个代理类结束掉。那在预编译的时候,编译器就会将这个宏转换成,这个具体的代理类,那这样呢,我们就实现了一个自己定义的接口。统共分三步,第一步呢,我们要实现一个接口类,第二个我们要在web rtc内部实现这个接口类。第三步呢,我们要通过宏定义一个代理类,那这样呢,
外层就可以使用这个代理类,最终调入到我们外部rtc内部实现的这个类了。那如何使用呢?那使用的时候也非常简单,就是通过你的类名加上proxy,然后调用它的静态方法。
由于我们在定义代理类时候没有加,所以呢,你需要传入和working th。最后,将我们之前定义的接口的对象指针放入进去,那这样呢,外层就可以通过这个方法来创建一个test proxy with internal。这样一个对象指针了它的返回值,就是test proxy with internal。
那有了这个指针之后,你后边儿就可以调用里边儿的方法了。那这些呢,回头在我们后边的课程中介绍外边tc代码的时候,我们再看一下外边tc是如何这个使用接口类的,那通过上面介绍呢,你应该对外边tc的接口宏有了一定了解。那至少我们应该通过这节课啊,掌握一点信息,就是说我们可以自己在外边rtc里边去定义自己的接口。如果我们需要的话,我们就可以随时增加自己的接口,那这些接口的定义实际是有一定规则的。不是说你随便定义一个接口,外边都可以调,
那你必须按照它的规则来实现,要实现这些接口呢,至少有三大步。第一大步,你要自己定义一个接口类,第二大步,你要在外部rtc源码的内部去实现你定义的这个接口类。第三步呢,我们要通过接口宏来实现一个代理类,最后一步是我们使用这个代理类来去调用我们真正的接口。那整个这过程啊,还是非常复杂的,那这其中的原因,我们在下节课中呢,给你做详细介绍,
那我们这节课呢,就到这里,谢谢。