README

与 Vzaar-api-php 一样，只是增加了命名空间。这也意味着将一些文件分开，vzaar 默认布局中一个文件中有几个类。

因此，这些文件现在都有自己的文件和命名空间。

如果你使用 laravel，你可以采用绑定 vzaar API PHP 客户端的方法

vzaar API PHP 客户端

vzaar API 客户端为 PHP 开发者提供。

vzaar 是商业视频托管平台的首选。价格合理，可定制且安全。利用在线视频的力量，通过 vzaar 实现商业。有关更多详细信息及注册，请访问 http://vzaar.com

####使用库

为了开始使用 vzaar API 库

require_once 'Vzaar.php';

Vzaar::$token = 'VZAAR_API_TOKEN';
Vzaar::$secret = 'VZAAR_USERNAME';

为了使用 vzaar API，你需要一个有效的用户名和 API 令牌，你可以在 http://app.vzaar.com/settings/api 的 vzaar 控制面板中获取。

接下来，你想做的第一件事是检查你的账户是否真正有效并且可以正常工作，你可以通过简单地调用 whoAmI 来完成。

echo(Vzaar::whoAmI());

如果它返回你的 vzaar 用户名，- 我们就可以开始了。

####用户详情

此 API 调用返回用户的公共详情及其相关元数据。它还包含可以在 getAccountDetails 调用中使用的 vzaar 账户 ID。

print_r(Vzaar::getUserDetails('VZAAR_USERNAME'));

其中 VZAAR_USERNAME 是 vzaar 用户名。此调用的结果将是 UserDetails 类型的对象。

####账户详情

此 API 调用返回每个 vzaar 订阅账户类型的详细信息以及相关元数据。这将显示此处提供的包的详细信息：http://vzaar.com/pricing

print_r(Vzaar::getAccountDetails(VZAAR_ACCOUNT_ID));

其中 VZAAR_ACCOUNT_ID 是 vzaar 分配的唯一账户 ID。

此调用的结果将是 AccountDetails 类型的对象。

####视频列表

此 API 调用返回用户的活跃视频列表及其相关元数据。默认情况下返回 20 个视频，但这是可定制的。

print_r(Vzaar::getVideoList('VZAAR_USERNAME', true, 10));

####视频详情

此 API 调用返回所选视频的元数据，如尺寸、缩略图信息、作者、时长、播放次数等。

print_r(Vzaar::getVideoDetails(VZAAR_VIDEO_ID, true));

其中 VZAAR_VIDEO_ID 是在视频处理后分配给视频的唯一 vzaar 视频 ID。

####上传签名

在某些情况下，你可能不需要从 API 实际上传，而是使用一些第三方上传器，如 S3_Upload 小部件或任何其他，因此你需要仅获取上传签名。

print_r(Vzaar::getUploadSignature());

####上传视频

直接从本地驱动器上传视频到 Amazon S3 存储桶。当您构建桌面应用程序或将视频直接从您的服务器上传到 vzaar 时，请使用此方法。

$filename = '548.mov'; // the file must be located in the same directory as the script. If not use full disk path

$file = getcwd() . '\\' . $filename;
echo('file to upload: ' . $file);
$result=Vzaar::uploadVideo($file);
echo($result);

####上传缩略图

使用视频 ID 上传视频的缩略图。

$video_id = 123;

$thumb_path = "/home/herk/my_image.jpg";
echo('uploading thumbnail for video:' . $video_id . ', file path:' . $thumb_path);
$result=Vzaar::uploadThumbnail($video_id, $thumb_path);
echo($result);

####上传缩略图

根据帧时间生成缩略图。

$video_id = 123;

$result=Vzaar::generateThumbnail($video_id, 3);
echo($result);

####通过 URL 上传视频

从 URL 上传新视频或替换现有视频

$url = "http://www.mywebsite.com/my_video.mp4";
echo('uploading video from url: ' . $url);
$video_id=Vzaar::uploadLink($url);
echo($video_id);

####处理视频

此 API 调用会指示 vzaar 系统处理新上传的视频。如果需要，它将对其进行编码，然后返回 vzaar 视频 ID。

$apireply = Vzaar::processVideo(GUID, VIDEO_TITLE, VIDEO_DESCRIPTION, VIDEO_LABELS, Profile::Original);
echo($apireply)

你需要将以下参数传递给此 API 函数

• GUID (字符串) - 指定要操作的GUID
• VIDEO_TITLE (字符串) - 指定视频的标题
• VIDEO_DESCRIPTION (字符串) - 指定视频的描述
• PROFILE (整数) - 指定编码视频的大小。如果未指定，将使用vzaar默认值或用户默认值（如果已设置）
• VIDEO_LABELS (字符串) - 要分配给视频的标签的逗号分隔列表

####编辑视频

此API调用允许用户编辑或更改系统中视频的详细信息。

$apiresult = Vzaar::editVideo(VIDEO_ID, VIDEO_TITLE, VIDEO_DESCRIPTION, MARK_AS_PRIVATE);

应将以下参数传递给方法

• VIDEO_ID (整数) - 要修改的视频的唯一vzaar视频ID
• VIDEO_TITLE (字符串) - 指定视频的新标题
• VIDEO_DESCRIPTION (字符串) - 指定视频的新描述
• MARK_AS_PRIVATE (布尔值) (true|false) - 标记视频为私有或公开

####删除视频

此API调用允许您从您的帐户中删除视频。如果删除成功，它将返回true，否则返回false。

$apiresult = Vzaar::deleteVideo(VZAAR_VIDEO_ID);

其中VZAAR_VIDEO_ID是在视频处理后分配给视频的唯一vzaar视频ID。

许可

在MIT许可证下发布。