Aller au contenu principal

Téléversement Drive

Le Drive de Misskey est le système de stockage de fichiers. Tous les fichiers joints aux notes doivent d'abord être téléversés vers votre Drive. La facade client.drive expose les sous-API files, folders et stats.

Consultez également Assistants Drive pour les opérations regroupant plusieurs requêtes, comme la liste de tous les fichiers, les déplacements en masse, les téléversements par lots et la suppression récursive de dossiers.

Téléverser un fichier​

import 'dart:io';

final bytes = await File('photo.jpg').readAsBytes();
final driveFile = await client.drive.files.create(
  bytes: bytes,
  filename: 'photo.jpg',
  comment: 'Alt text for accessibility',
);

print(driveFile.id);  // Use this ID to attach to a note
print(driveFile.url); // Public URL

Téléversement avec dossier et sensibilité​

final driveFile = await client.drive.files.create(
  bytes: bytes,
  filename: 'nsfw.jpg',
  folderId: myFolderId,
  isSensitive: true,
  force: true, // Upload even if a file with the same content already exists
);

Misskey déduplique les téléversements par contenu (hachage MD5), et non par nom. Sans force, le téléversement d’un contenu déjà présent dans votre Drive renvoie le fichier existant, et les paramètres folderId, name et comment demandés sont ignorés. Pour éviter tout transfert des octets, consultez createDeduplicated() dans Assistants Drive.

Progression du téléversement​

final driveFile = await client.drive.files.create(
  bytes: largeBytes,
  filename: 'large-video.mp4',
  onSendProgress: (sent, total) {
    final percent = (sent / total * 100).toStringAsFixed(1);
    print('Uploading: $percent%');
  },
);

Téléversement depuis une URL​

await client.drive.files.uploadFromUrl(
  url: 'https://example.com/image.jpg',
  folderId: myFolderId,
  isSensitive: false,
);

Il s'agit d'un point d'accès de type fire-and-forget ; le fichier apparaît dans le Drive de façon asynchrone. force a le même sens que pour create(). Pour attendre le fichier obtenu, utilisez uploadFromUrlAndWait().

Joindre des fichiers Drive aux notes​

final driveFile = await client.drive.files.create(
  bytes: imageBytes,
  filename: 'photo.jpg',
);

final note = await client.notes.create(
  text: 'Check this out!',
  fileIds: [driveFile.id],
);

Plusieurs fichiers peuvent être joints en passant plusieurs identifiants dans fileIds.

Lister les fichiers​

// List files in the root folder
final files = await client.drive.files.list(limit: 20);

// List files in a specific folder
final files = await client.drive.files.list(
  limit: 20,
  folderId: myFolderId,
);

// Filter by MIME type
final images = await client.drive.files.list(type: 'image/*');

// Sort by size descending
final large = await client.drive.files.list(sort: '+size');

sort accepte : +createdAt, -createdAt, +name, -name, +size, -size (+ signifie décroissant).

Seul +createdAt (ou l’absence de sort) est cohérent avec la pagination untilId. Les autres tris modifient l’ordre tandis que le curseur filtre toujours par ID ; des éléments peuvent donc être omis ou répétés. Pour lister tous les fichiers, utilisez listAll() et triez localement ; consultez Assistants Drive.

Flux (tous les fichiers, sans filtre de dossier)​

final all = await client.drive.stream(limit: 20, type: 'video/*');

Rechercher par nom​

final found = await client.drive.files.find(
  name: 'photo.jpg',
  folderId: myFolderId,
);

Vérifier les doublons​

final exists = await client.drive.files.checkExistence(md5: fileMd5);

Récupérer les détails d'un fichier​

// By file ID
final file = await client.drive.files.showByFileId(fileId);

// By URL
final file = await client.drive.files.showByUrl('https://example.com/file.jpg');

Mettre à jour les attributs d'un fichier​

final updated = await client.drive.files.update(
  fileId: driveFile.id,
  name: 'new-name.jpg',
  comment: Optional('Updated alt text'), // Optional.null_() clears it
  isSensitive: false,
);

Déplacer vers un autre dossier :

await client.drive.files.update(
  fileId: driveFile.id,
  folderId: newFolderId,
);

Déplacer vers la racine :

await client.drive.files.update(
  fileId: driveFile.id,
  moveToRoot: true,
);

Supprimer des fichiers​

await client.drive.files.delete(fileId: driveFile.id);

Gestion des dossiers​

// List root folders
final folders = await client.drive.folders.list();

// Create a folder
final folder = await client.drive.folders.create(
  name: 'Vacation Photos',
);

// Create a nested folder
final nested = await client.drive.folders.create(
  name: 'Day 1',
  parentId: folder.id,
);

// Rename a folder
await client.drive.folders.update(
  folderId: folder.id,
  name: 'Summer 2025',
);

// Move to root
await client.drive.folders.update(
  folderId: folder.id,
  moveToRoot: true,
);

// Delete a folder (must be empty)
await client.drive.folders.delete(folderId: folder.id);

Statistiques du Drive​

final capacity = await client.drive.stats.getCapacity();
print('Used: ${capacity.usage} bytes');
print('Capacity: ${capacity.capacity} bytes');