跳到主要内容

mbga.Avatar

オブジェクト​

NameTypeDescription
idUserId–
sizeEnumAvatarSize–
viewEnumAvatarView–
emotionEnumAvatarEmotion–
dimensionEnumAvatarDimension–
transparentBoolean–
typeEnumAvatarType–
extensionEnumAvatarExtension–
motionInterger–
sceneAvatarMotionScenes–
fpsInteger–
movieClipString–
urlString–

EnumAvatarSize と EnumAvatarView, EnumAvatarExtension の対応関係は下記です。

sizeviewwidthheightextensionsupport
xlargeentire150200gif, swftrue
xlargeupper–––false
largeentire120160gif, swftrue
largeupper6080gif, swftrue
mediumentire6080gif, swftrue
mediumupper3040gif, swftrue
smallentire3040gif, swftrue
smallupper–––false

EnumAvatarDimension と transparent の対応関係は下記です。

dimensiontransparentsupport
2dtruefalse
2dfalsetrue
3dtruetrue
3dfalsetrue
EnumAvatarSize​
KeyDescription
xlargeAvatar.view が 'entire' の時のみ利用可能
large–
medium–
small–
AvatarMotionScenes​

AvatarMotionScenes は下記の BNF で定められたフォーマットの String 型のデータです。

AvatarMotionScenes = AvatarMotionScene *( "-" AvatarMotionScene ){1,7}
AvatarMotionScene = AvatarMotionLabel "." ( AvatarFrameId *( "." AvatarFrameId ) ) "." AvatarEndExpression
AvatarMotionLabel = ALPHA / DIGIT / "_"
AvatarFrameId = Integer
AvatarEndExpression = "loop" / "stop"

例えば、

s1.10.11.stop-s2.13.15.loop

ならば、シーンラベル s1 はフレーム 10, 11 から成り、繰り返しはありません。続いてシーンラベル s2 はフレーム 13, 15 から成り、13, 15 と繰り返されます。
view が upper の場合は省略可能ですが、entire の場合は指定しなければなりません。

メソッド​

mbga.Avatar.getId​

String getId()

mbga.Avatar.getUrl​

String getUrl()

mbga.Avatar.getField​

Object getField(name)

mbga.Avatar.setField​

void setField(name, value)

mbga.Avatar.Field​

mbga.Avatar.Field.ID​

アバター画像のID。

mbga.Avatar.Field.SIZE​

アバター画像のサイズ。mbga.Enum.Avatar.Sizeが指定できます。

mbga.Avatar.Field.VIEW​

アバター画像のビュー。mbga.Enum.Avatar.Viewが指定できます。

mbga.Avatar.Field.EMOTION​

アバター画像の表情。mbga.Enum.Avatar.Emotionが指定できます。

mbga.Avatar.Field.DIMENSION​

アバター画像の次元。mbga.Enum.Avatar.Dimensionが指定できます。
(PC版では3Dアバターのみ提供)

mbga.Avatar.Field.TRANSPARENT​

アバター画像の背景を透明にするかどうか。

mbga.Avatar.Field.TYPE​

アバター画像の種類。mbga.Enum.Avatar.Typeが指定できます。

mbga.Avatar.Field.EXTENSION​

アバター画像の拡張子。mbga.Enum.Avatar.Extensionが指定できます。

mbga.Avatar.Field.MOTION​

アバター画像のモーション。

mbga.Avatar.Field.SCENE​

アバター画像のシーン。

mbga.Avatar.Field.FPS​

アバター画像のfps。(指定可能な値は0〜35の間)

mbga.Avatar.Field.MOVIE_CLIP​

アバター画像のムービークリップ。

mbga.Avatar.Field.URL​

アバター画像のURL。

mbga.AvatarRequestFields​

mbga.newFetchAvatarRequest, mbga.requestFetchAvatar の opt_params で用いる事の出来るフィールド一覧です。

mbga.AvatarRequestFields.SORT_BY​

mbga.AvatarRequest.SortByが指定できます。

mbga.AvatarRequestFields.SORT_ORDER​

mbga.AvatarRequest.SortOrder が指定できます。

mbga.AvatarRequestFields.FORMAT​

mbga.AvatarRequest.Format が指定できます

mbga.AvatarRequestFields.FIELDS​

mbga.Avatar.Fieldsのうちから獲得したいフィールドを並べた配列を指定します。

mbga.AvatarRequest.SortBy​

mbga.AvatarRequest.SortBy.ID​

mbga.Avatar.Field.IDによってavatarオブジェクトをソートします。以下は、IDの昇順にソートされたデータを取得するサンプルです。

サンプル​
var idSpec = opensocial.newIdSpec();
idSpec.setField(opensocial.IdSpec.Field.USER_ID, [ opensocial.IdSpec.PersonId.VIEWER ]);
idSpec.setField(opensocial.IdSpec.Field.GROUP_ID, opensocial.IdSpec.GroupId.SELF);

var opt_params = {};
opt_params[mbga.AvatarRequestFields.SORT_ORDER] = mbga.AvatarRequest.SortOrder.ASCENDING;
opt_params[mbga.AvatarRequestFields.SORT_BY] = mbga.AvatarRequest.SortBy.ID;

mbga.requestFetchAvatar(idSpec, opt_params, function(data) {

if ( data.hadError() ) {
alert("response had error!");
}
else {
var avatars = data.getData();
// do something
}

});

mbga.AvatarRequest.SortOrder​

mbga.AvatarRequest.SortOrder.ASCENDING​

キーとなる値の昇順でavatarオブジェクトをソートします。

mbga.AvatarRequest.SortOrder.DESCENDING​

キーとなる値の降順でavatarオブジェクトをソートします。

mbga.AvatarRequest.Format​

mbga.AvatarRequest.Format.JSON​

mbga.Enum.Avatar.Size​

mbga.Enum.Avatar.Size.X_LARGE​

アバター画像のサイズを特大(150px × 200px)にします。

mbga.Enum.Avatar.Size.LARGE​

アバター画像のサイズを大(120px × 160px)にします。

mbga.Enum.Avatar.Size.MEDIUM​

アバター画像のサイズを中(60px × 80px)にします。

mbga.Enum.Avatar.Size.SMALL​

アバター画像のサイズを小(30px × 40px)にします。

mbga.Enum.Avatar.View​

mbga.Enum.Avatar.View.ENTIRE​

アバター画像の全身を表示するビューです。

mbga.Enum.Avatar.View.UPPER​

アバター画像の上半身を表示するビューです。

mbga.Enum.Avatar.Emotion​

mbga.Enum.Avatar.Emotion.DEFINED​

アバター画像の表情をデフォルトの値(ユーザ指定)にします。

mbga.Enum.Avatar.Emotion.NORMAL​

アバター画像の表情をノーマルにします。

mbga.Enum.Avatar.Emotion.SMILE​

アバター画像の表情を笑った顔にします。

mbga.Enum.Avatar.Emotion.CRY​

アバター画像の表情を泣いている顔にします。

mbga.Enum.Avatar.Emotion.ANGRY​

アバター画像の表情を怒っている顔にします。

mbga.Enum.Avatar.Emotion.SHY​

アバター画像の表情を恥ずかしがっている顔にします。

mbga.Enum.Avatar.Dimension​

mbga.Enum.Avatar.Dimension.DEFINED​

アバター画像の次元をデフォルトの値(ユーザ指定)にします。

mbga.Enum.Avatar.Dimension.THREE_DIMENSION​

アバター画像を3Dにします。

mbga.Enum.Avatar.Type​

mbga.Enum.Avatar.Type.IMAGE​

アバター画像の種類を通常画像にします。

mbga.Enum.Avatar.Type.FLASH​

アバター画像の種類をFLASHにします。

mbga.Enum.Avatar.Extension​

mbga.Enum.Avatar.Extension.GIF​

アバター画像の拡張子をgifにします。

mbga.Enum.Avatar.Extension.SWF​

アバター画像の拡張子をswfにします。

更新履歴​

  • 2010/12/16
    • mbga.Avatar dimention -> dimension に修正