newbiecoder99 / uptube
使用 Laravel 5 上传视频到 YouTube。
Requires
- php: ^7.0
- google/apiclient: ^2.2
- illuminate/support: ^5.4
- nesbot/carbon: ^1.22
Requires (Dev)
- orchestra/testbench: ~3.2
- phpunit/phpcov: ~3.0
- phpunit/phpunit: ~5.0
This package is auto-updated.
Last update: 2024-09-17 09:44:38 UTC
README
请注意,此包仅适用于单个 YouTube 账户,不支持多个账户。
安装
要安装,请使用以下命令通过 Composer 拉取包。
composer require newbiecoder99/uptube
现在在 config/app.php 中注册服务提供者
'providers' => [ ... Newbiecoder99\Uptube\UptubeServiceProvider::class, ],
并将别名添加到同一文件中
'aliases' => [ ... 'Uptube' => Newbiecoder99\Uptube\Facades\Uptube::class, ],
配置
您现在需要发布 youtube.php 配置和迁移。
php artisan vendor:publish --provider="Newbiecoder99\Uptube\UptubeServiceProvider"
现在运行 php artisan migrate 来创建 youtube_access_tokens 表,该表将包含您正确认证后的访问令牌。
获取凭证
如果您尚未创建,您需要在 谷歌开发者控制台 上创建一个应用程序。然后,您需要进入控制台中的 凭证 以创建服务器密钥。
您将被要求输入授权的重定向 URI。在安装此包时,默认的重定向 URI 是 http://laravel.dev/youtube/callback。当然,用您的应用程序域名(laravel.dev)替换域名。
您可以添加多个重定向 URI,例如,您可能希望添加本地、测试和生产服务器的 URI。
一旦您对一切都感到满意,创建凭证,您将获得一个 客户端 ID 和 客户端密钥。这些现在需要添加到您的 .env 文件中。
GOOGLE_CLIENT_ID=YOUR_CLIENT_ID
GOOGLE_CLIENT_SECRET=YOUR_SECRET
身份验证
出于安全原因,默认情况下禁用了授权您的频道与 Laravel 应用程序的路由。在执行以下操作之前,您需要在您的 config/youtube.php 中启用它们。
现在您的应用程序已配置,我们将进行 Google 的初始身份验证。默认情况下,授权路由是 /youtube/auth。只需访问此 URI 并将重定向到 Google 以验证您的 YouTube 账户。
假设您在身份验证过程中没有遇到任何错误,您将被重定向回您的应用程序根目录。(/)
检查您的令牌
以前,此包的用户报告了访问令牌的问题。为确保您有正确的令牌,您只需查看您之前迁移的 youtube_access_tokens 表,并查看 access_token 列的值。
您需要检查此值中是否存在 refresh_token。如果正确,您就可以开始上传了。
您还希望禁用用于授权的路线,因为您现在已认证,它们将不再需要。您刚才检查的令牌,假设是一个 refresh_token,将自动处理。
上传视频
要上传视频,您只需传递您想要上传的视频的完整路径,并指定视频信息。
以下是一个示例
$video = Uptube::upload($fullPathToVideo, [ 'title' => 'My Awesome Video', 'description' => 'You can also specify your video description here.', 'tags' => ['foo', 'bar', 'baz'], 'category_id' => 10 ]); return $video->getVideoId();
上面的代码将返回上传到 YouTube 的视频 ID。(例如 dQw4w9WgXcQ)
默认情况下,视频上传是公开的。如果您想更改上传的隐私设置,您可以通过传递上传方法的第三个参数来做到这一点。
例如,下面的代码将视频上传为 unlisted。
$video = Uptube::upload($fullPathToVideo, $params, 'unlisted');
自定义缩略图
如果您想为上传设置自定义缩略图,您可以使用 withThumbnail() 方法进行链式调用。
$fullpathToImage = storage_path('app/public/thumbnail.jpg'); $video = Uptube::upload($fullPathToVideo, $params)->withThumbnail($fullpathToImage); return $youtube->getThumbnailUrl();
请注意,缩略图的最大文件大小为2MB。如果尝试使用超过这个大小的缩略图,设置缩略图将不会生效。
更新视频
要更新视频,您只需传递您想要更新的视频的 videoId 并指定您的视频信息。
以下是一个示例
$video = Uptube::update($videoId, [ 'title' => 'My Awesome Video', 'description' => 'You can also specify your video description here.', 'tags' => ['foo', 'bar', 'baz'], 'category_id' => 10 ], $privacy); return $video->getVideoId();
注意:此请求是明确的。请求中省略的任何参数将被删除。
删除视频
如果您想删除视频,当然是在您授权的频道上上传的视频,您也将有删除它的能力
Uptube::delete($videoId);
删除视频时,它将检查视频是否存在,然后再尝试删除。
感谢: Joe Dawson 更新它,因为使用 YouTube Pakcage 与 Alaouy 存在冲突 ^_^