libvlc外部api的简单整理

libvlc.h

定义了libvlc的外部api，引用这个头文件就可以把VLC嵌入到我们的程序里面了。

libvlc的对象必须先被初始化之后才能被使用。

 

libvlc core

• libvlc_new() 用于初始化一个libvlc的实例，argc表示参数的个数，argv表示参数，返回创建的实例若当发生错误时返回NULL
• libvlc_release()用于销毁一个libvlc的实例

•  　　libvlc error handling

  • libvlc_errmsg()返回的是在idaoyong线程中产生的最新的libvlc错误，这个错误信息至少在另外一个错误发生之前（至少再调用一次libvlc）都是有效的，当没有任何错误的时候返回的是NULL
  • libvlc_clearerr()用于清除当前线程的libvlc的错误状态.此操作是可选的,默认情况下,错误状态是会在新的错误发生时被覆盖.
  • libvlc_vprinterr()用于设置当前线程的libvlc的错误状态和消息.无论何时都返回一个nul字符
  • libvlc_printerr() /源码里的注释和上一个一模一样
  • libvlc_retain()增加libvlc的引用计数,任何新的libvlc实例的引用计数为1
  • libvlc_add_intf():尝试启动libvlc实例的用户接口,p_instance表示要启动的实例,name为接口名,NULL表示默认,返回0表示成功-1表示发生错误
  • libvlc_set_exits_handler():此函数用于为一个已存在的libvlc事件注册一个回调.此方法在你用libvlc_add_intf()开启了至少一个接口时非常有用.典型的,这个函数将唤醒你的程序主循环(从其他线程).参数p_instance 表示libvlc实例,cb表示当libvlc要退出时要调用的回调.opaque表示回调的数据指针.警告:此函