5.10.WebRTC接口宏

那今天呢？我给大家介绍一下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源码的内部去实现你定义的这个接口类。第三步呢，我们要通过接口宏来实现一个代理类，最后一步是我们使用这个代理类来去调用我们真正的接口。那整个这过程啊，还是非常复杂的，那这其中的原因，我们在下节课中呢，给你做详细介绍，

那我们这节课呢，就到这里，谢谢。