MobileVLCKit是开源播放器VLC的iOS平台框架，在Mac OS上也有对应的VLCKit，搞直播的同学应该不陌生，不过它其实还是一款强大的本地播放器，支持几乎所有的主流媒体格式。最近在研究app如何浏览电脑上文件，然后直接做到播放视频的功能。用过iOS上的VLC播放器的童鞋应该知道，他能做到扫描本地端口，然后通过输入用户名和密码浏览电脑的文件，点击视频和音频还能直接播放。
通过Google知道这里用到一个叫SMB的协议，不光是Mac OS上，Windows和Linux都支持这种协议。只要本地开启SMB的文件共享服务，同一个局域网内的设备就能通过它访问电脑上的文件了。
上上gayhub发现了一个SMB的iOS框架，叫TOSMBClient，它将一个C语言的框架封装成了OC的框架。还支持CocoaPods，使用起来非常方便。而MobileVLCKit原生就支持SMB协议的在线播放。所以解决方案是通过TOSMBClient获取文件列表，VLC播放，想法很美好，但是实际实现还是踩了不少坑。

先说说SMB的格式，长这样：smb://{hostname}:{password}@{ip}/path 比如桌面上的一个mp4文件就应该长这样：smb://xiaoming:123456@192.168.1.100/xiaoming/Desktop/233.mp4
hostname是域名，一般创建SMB共享协议的时候，就需要指定。password是密码，ip是服务器的ip。
TOSMBClient提供了一个登录的类叫TOSMBSession，常用属性是这几个

1
2
3
4
5
6
7
8
//服务器域名
@property (nonatomic, copy) NSString *hostName;
//服务器ip
@property (nonatomic, copy) NSString *ipAddress;
//登录的用户名
@property (nonatomic, copy) NSString *userName;
//登录密码
@property (nonatomic, copy) NSString *password;

其中域名和ip可以都设置，也可以只设置其中一个，框架会自动查找。
然后通过TOSMBSession提供的方法

1
2
3
- (void)requestContentsOfDirectoryAtFilePath:(NSString *)path
success:(void (^)(NSArray *files))successHandler
 error:(void (^)(NSError *))errorHandler;

获取文件列表，很简单。返回的files是TOSMBSessionFile类型。它包含基本的文件信息，比如路径，名称，大小。想法挺美好，有URL，直接给VLC播放不就行了，然后就碰到了第一个坑。
TOSMBSessionFile提供的路径只是smb格式的一部分，也就只有path部分，所以需要播放还得自己拼接成完整路径。

拼接好了之后尝试下播放个文件，没带中文的，成功了，高兴之余本着严谨的态度试了下中文路径，结果失败了。NSURL初始化如果包含标准ASCALL以外的字符，会返回nil，这是第二个坑。

作为程序员，很自然会想到，URL如果带中文，浏览器会自动做URL转码。所以尝试下转码，发现还是播放失败。这就让我怀疑人生了，怎么肥事？而且连iOS上的VLC的app都有这个问题，这是第三个坑。

通过查找API我发现播放器除了通过NSURL初始化，还可以通过NSString初始化，我想，NSURL不让包含中文，NSString总可以吧。结果还是播放失败，神奇的是即使不包含中文，通过NSString初始化还是失败，但是NSURL就可以，这是第四个坑。

既然一定要实现功能，那就得搞明白为什么，这时候开源的好处就体现出来了，我看了下MobileVLCKit的源码，它的媒体类VLCMedia是这么写的：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
- (instancetype)initWithPath:(NSString *)aPath
{
    return [self initWithURL:[NSURL fileURLWithPath:aPath isDirectory:NO]];
}

- (instancetype)initWithURL:(NSURL *)anURL
{
    if (self = [super init]) {
        const char *url;
        VLCLibrary *library = [VLCLibrary sharedLibrary];
        NSAssert(library.instance, @"no library instance when creating media");

        if (([[anURL absoluteString] hasPrefix:@"sftp://"]) ||
            ([[anURL absoluteString] hasPrefix:@"smb://"])) {
            url = [[[anURL absoluteString] stringByRemovingPercentEncoding] UTF8String];
        } else {
            url = [[anURL absoluteString] UTF8String];
        }

        p_md = libvlc_media_new_location(library.instance, url);

        _metaDictionary = [[NSMutableDictionary alloc] initWithCapacity:3];

        [self initInternalMediaDescriptor];
    }
    return self;
}

可以看到，initWithPath:方法把字符串通过fileURLWithPath:isDirectory:方法初始化成URL了，所以smb格式的字符串路径通过这个方法初始化得到的路径肯定是错的，因为它不是标准的本地路径，自然会出现上面神奇的情况。
然后看下initWithURL:方法，if语句判断如果包含smb前缀，则做URL解码操作。说明我们的想法是正确的，确实应该对URL进行编码。但是，经过测试编码还是不行，这种情况就很费解了。到现在我还不知道什么原因，因为它自己的APP都有这个问题。不过之后偶然发现了解决方法，很简单

把URL编码两次即可！！
把URL编码两次即可！！
把URL编码两次即可！！

重要的事情说三遍，编码两次之后框架会对URL解码一次，所以得到的URL实际是编码了一次的内容，这样就能播放了，非常神奇，这是第五个坑。在这里分享一下给需要的童鞋。

注意事项

应该只对path、hostname、password部分做URL两次编码，smb://前缀不需要，否则播放器会无法识别。

2017.10.16日更新 如果发现拼接之后还是没法播放，大部分是因为VLC的版本比较旧的关系，cocoapods里有最新的unstable版本，用这个，不过这个版本也是最不稳定的。

2018.7.8日更新 文章Demo