Aller au contenu principal

Téléversement de médias

L'API client.media gère les téléversements de fichiers avec prise en charge automatique du traitement asynchrone.

Téléverser un média​

import 'dart:io';

final bytes = await File('photo.jpg').readAsBytes();
final attachment = await client.media.upload(
  bytes,
  'photo.jpg',
  description: 'Alt text for accessibility',
);

print(attachment.id);
print(attachment.url);

Téléverser avec une vignette​

final thumbnailBytes = await File('thumb.jpg').readAsBytes();

final attachment = await client.media.upload(
  videoBytes,
  'video.mp4',
  description: 'A short clip',
  thumbnail: thumbnailBytes,
  thumbnailFilename: 'thumb.jpg',
);

Point focal​

Le point focal détermine quelle partie de l'image reste visible lors du recadrage. Les valeurs vont de -1.0 à 1.0 pour les deux axes :

final attachment = await client.media.upload(
  bytes,
  'photo.jpg',
  focus: '0.0,-0.5', // Center horizontally, upper half
);

Traitement asynchrone​

Lorsque le serveur retourne HTTP 202 (traitement asynchrone), la bibliothèque interroge automatiquement GET /api/v1/media/{id} jusqu'à ce que le champ url soit disponible. Cela est transparent pour l'appelant.

Si le traitement ne se termine pas dans la limite d'interrogation (8 tentatives espacées de 500ms), une MastodonMediaProcessingTimeoutException est levée :

try {
  final attachment = await client.media.upload(bytes, 'large-video.mp4');
} on MastodonMediaProcessingTimeoutException catch (e) {
  // Check status later
  final attachment = await client.media.fetchById(e.mediaId);
  if (attachment.url != null) {
    print('Processing complete: ${attachment.url}');
  }
}

Mettre à jour les attributs d'un média​

Mettez à jour le texte alternatif, la vignette ou le point focal avant d'attacher le média à un statut :

final updated = await client.media.update(
  attachment.id,
  description: 'Updated alt text',
  focus: '0.5,0.0',
);

Supprimer un média non attaché​

Seuls les médias non encore attachés à un statut peuvent être supprimés :

await client.media.delete(attachment.id);

Repli de version d'API​

La bibliothèque préfère POST /api/v2/media et bascule automatiquement vers POST /api/v1/media pour les serveurs ne supportant pas v2 (HTTP 404, 405 ou 501). Cela est géré de manière transparente.

Attacher à un statut​

final attachment = await client.media.upload(bytes, 'photo.jpg',
  description: 'A scenic view',
);

final result = await client.statuses.create(
  MastodonStatusCreateRequest(
    status: 'Check out this view!',
    mediaIds: [attachment.id],
  ),
);

On peut attacher jusqu'à 4 images ou 1 vidéo/audio par statut (selon la configuration du serveur).