libcast/assetdistribution

PHP component that can publish digital assets (video, audio...) across multiple services. Currently supports YouTube, Vimeo and Dailymotion.

AssetDistributor

, _(*1)

AssetDistributor is a PHP component that can publish digital assets (video, audio...) across multiple services., _(*2)

Currently, AssetDistributor can publish videos across YouTube, Vimeo and DailyMotion. Feel free to help and integrate new Adapters for new services., _(*3)

Vocabulary

• Asset — describes a digital media of one of the following type : audio, document, image or video., _(*4)

• Adapter — implements a service to upload, update or delete Asset objetcs from., _(*5)

• AdapterCollection — contains multiple Adapter objects and is traversable, _(*6)

• Owner — handles an AdapterCollection and the corresponding services account credentials., _(*7)

Installation

The component may be added through composer :, _(*8)

composer require libcast/assetdistributor

Configuration

All your application oAuth credentials or any other configuration must be stored in a PHP configuration file. You may have a look on example/configuration.ini as an example., _(*9)

Usage

First create an Owner called "me" to bear accounts credentials and an AdapterCollection, _(*10)

$cache = new \Doctrine\Common\Cache\FilesystemCache('/tmp'); // Doctrine Cache is a dependency
$owner = new Owner('me', $cache);

Then create an Asset from an existing file, _(*11)

$asset = AssetFactory::build(
    "$root/tests/video.mp4",        // path to file of a Flysystem\File object
    'My Video',                     // optional title
    'This is an awesome video',     // optional description
    ['test', 'asset-distributor']   // optional array of tags
);
$asset->setVisibility('private');

You may create an AdapterCollection manually:, _(*12)

/** @var string $configPath Path to the PHP configuration file */

$adapters = new AdapterCollection;
$adapters[] = new YouTubeAdapter($owner, $configPath);
$adapters[] = new VimeoAdapter($owner, $configPath);

You also can retrieve the AdapterCollection from the cache:, _(*13)

$adapters = AdapterCollection::retrieveFromCache($owner, $configPath);

Or you can create an AdapterCollection based on the Asset :, _(*14)

$adapters = AdapterCollection::buildForAsset($asset, $owner, $configPath);

Once created, the AdapterCollection must be affiliated to the Owner, _(*15)

$owner->setAdapters($adapters);

At this point, you may manipulate your Asset across all services like this:, _(*16)

// Upload the Asset on all services
$owner->upload($asset);

$asset->setTitle('Different title');
$asset->addTag('foobar');

// Update the Asset on all services
$owner->update($asset);

// Delete the Asset on all services
$owner->delete($asset);