アダプティブ カード拡張機能でのメディア のアップロード
注:
アダプティブ カード拡張機能のメディア アップロード機能は、SPFx v1.15.2 で利用できます。
SPFx v1.15.2 のインストールの詳細については、「SharePoint Framework v1.15.2 リリース ノート」を参照してください。
このチュートリアルは、SharePoint アダプティブ カード拡張機能を既に構築してあることが前提となっています。
初めての SharePoint アダプティブ カード拡張機能の作成方法を学ぶには、このチュートリアルをお試しください。
メディアアップロードのアクションの種類
メディアを選択する
ユーザーがアダプティブ カード拡張機能 (ACE) を使用してメディア コンテンツをアップロードできるようにします。 現在のサイズ制限は、イメージあたり 1 MB です。 ユーザーは、アップロードする任意のイメージの種類を指定できます。 注: イメージの種類が指定されていない場合は、画像のみをアップロードできることを示すエラーが表示されます。
[メディアの選択] の ACE アクションは です VivaAction.SelectMedia
。
受け取るパラメーターは次のとおりです。
mediaType
: 現在、既定でイメージとして設定されています。 オーディオ オプションは、今後サポートされる予定です。allowMultipleCapture
[省略可能]: 複数のファイルを一度に追加できるようにします。- これは既定で有効になっています。
maxSizePerFile
[省略可能]: アップロードするファイル サイズの制限、推奨される制限は 1 MB です。supportedFileFormats
[省略可能]: 許可される型のスペース区切り形式。 何も指定されていない場合は、標準イメージ ファイルが型チェックに使用されます。- アップロードしようとしているファイルが許可された型と一致しない場合、次のエラー メッセージが表示されます。 これは、サポートされているファイルの種類ではありません。画像のみをアップロードできます。
{
/**
* Specify the specific media type that should be selected
*/
mediaType: MediaType;
/**
* Allow multiple images to be selected.
*/
allowMultipleCapture?: boolean;
/**
* Max file size that can be uploaded.
*/
maxSizePerFile?: number;
/**
* File formats supported for upload.
*/
supportedFileFormats?: string[];
}
チュートリアルと例
このチュートリアルでは、利用可能なメディアアップロードアクションを使用してカードを作成する方法に関するステップバイステップガイドを参照してください。
画像をアップロードする
テンプレート json ファイルに、次のアクションを追加します。
"actions": [ { "type": "VivaAction.SelectMedia", "id": "Select Media", "title": "Upload Image", "parameters": { "mediaType": MediaType.Image } } ]
複数の画像をアップロードする
テンプレート json ファイルに、次のアクションを追加します。
"actions": [ { "type": "VivaAction.SelectMedia", "id": "Select Media", "title": "Upload Image", "parameters": { "mediaType": MediaType.Image, "allowMultipleCapture": true } } ]
JPG 画像のみをアップロードする
テンプレート json ファイルに、次のアクションを追加します。
"actions": [ { "type": "VivaAction.SelectMedia", "id": "Select Media", "title": "Upload Image", "parameters": { "mediaType": MediaType.Image, "supportedFileFormats": "jpg" } } ]
[アップロード] では、小さな画像のみをアップロードできます
テンプレート json ファイルに、次のアクションを追加します。
"actions": [ { "type": "VivaAction.SelectMedia", "id": "Select Media", "title": "Upload Image", "parameters": { "mediaType": MediaType.Image, "supportedFilemaxSizePerFileFormats": 1000 } } ]
カード デザイナー カードのプロパティ ウィンドウを使用してメディアアップロードアクションにアクセスする
新しい ACE を作成する必要はなく、メディアのアップロードが動作していることを確認する場合は、プロパティ ウィンドウでこれを調べることができます 。このチュートリアル を確認してください。
注:
メディアのアップロード アクションは、カード ビュー、カード ビューのボタン、またはクイック ビュー自体に追加できます。
メディアアップロードアクションの可用性
注:
現時点では、この機能は Teams モバイルではサポートされていないため、これを示すエラーがスローされます。
Action | Viva 接続デスクトップ | Viva Connections Mobile | ブラウザー |
---|---|---|---|
メディアを選択する | サポート | サポート対象外 | サポート |